dotnet/maui · error · InvalidOperationException

Setting a Parent on Application is invalid.

Error message

Setting a Parent on Application is invalid.

What it means

Thrown by Application.OnParentSet, which is overridden to unconditionally throw because Application is the root of the visual/logical tree and is not allowed to have a parent. Any attempt to assign a parent to an Application instance is rejected at the point the Parent property would commit the change.

Source

Thrown at src/Controls/src/Core/Application/Application.cs:352

		}

		public event EventHandler<Page>? PageAppearing;

		public event EventHandler<Page>? PageDisappearing;

		/// <inheritdoc/>
		public IPlatformElementConfiguration<T, Application> On<T>() where T : IConfigPlatform
		{
			return _platformConfigurationRegistry.Value.On<T>();
		}

		protected virtual void OnAppLinkRequestReceived(Uri uri)
		{
		}

		protected override void OnParentSet()
		{
			throw new InvalidOperationException("Setting a Parent on Application is invalid.");
		}

		protected virtual void OnResume()
		{
		}

		protected virtual void OnSleep()
		{
		}

		protected virtual void OnStart()
		{
		}

		internal static void ClearCurrent() => Current = null;

		internal static bool IsApplicationOrNull(object? element) =>
			element == null || element is IApplication;

View on GitHub (pinned to f377ff1c5e)

Solutions

1. Do not set Parent on Application; restructure so the Application stays the root and children are added via Windows.
2. If you need a logical container, put it on a Window/Page rather than on Application.
3. Audit any reflection or generic Element helpers that call set_Parent to ensure they skip Application instances.

Example fix

// before
app.Parent = hostElement; // throws
// after
// Application is the root; do not assign a parent.
// Move hostElement under a Window/Page instead.

// Never parent an Application; if a helper sets Parent generically, skip Application instances.
static void SafeSetParent(Element child, Element parent)
{
    if (child is Application) throw new InvalidOperationException("Application cannot have a parent.");
    child.Parent = parent;
}

static bool CanHaveParent(Element e) => e is not Application;

When it happens

Trigger: Code sets application.Parent = something (or adds the Application to a parent element) so that the Element Parent setter eventually calls OnParentSet, which throws InvalidOperationException.

Common situations: Manually wiring Application into a custom host; misusing Element helpers (e.g. AddLogicalChild / parenting helpers) on the Application; porting code that parented a page-like root onto the new Application model.

Related errors

• The property {0} cannot be null at this time.
• The property {0} must be null at this time.
• No IAppIndexingProvider was provided
• No AppLinks implementation was found, if in Android make sur
• Both MainPage was set and CreateWindow was overridden to pro

AI-assisted analysis of dotnet/maui@f377ff1c5e (2026-08-13). Data as JSON: /api/errors/572b513668db9d13. Report an issue: GitHub.