dotnet/maui · error · InvalidOperationException

LoadView must be called before accessing View

Error message

LoadView must be called before accessing View

What it means

Thrown by the Android ShellSearchView when the IShellSearchView.View getter is accessed before IShellSearchView.LoadView() has been called. The getter checks if _searchButton is null (which is only initialized in LoadView) and throws InvalidOperationException. This enforces a strict initialization order: the search view's content must be inflated before the view itself is accessed.

Source

Thrown at src/Controls/src/Core/Compatibility/Handlers/Shell/Android/ShellSearchView.cs:37

using AView = Android.Views.View;
using LP = Android.Views.ViewGroup.LayoutParams;

namespace Microsoft.Maui.Controls.Platform.Compatibility
{
	public class ShellSearchView : FrameLayout, IShellSearchView, TextView.IOnEditorActionListener, ITextWatcher
	{
		#region IShellSearchView

		public event EventHandler SearchConfirmed;

		public SearchHandler SearchHandler { get; set; }

		AView IShellSearchView.View
		{
			get
			{
				if (_searchButton == null)
					throw new InvalidOperationException("LoadView must be called before accessing View");
				return this;
			}
		}

		void IShellSearchView.LoadView()
		{
			LoadView(SearchHandler);
			if (_searchHandlerAppearanceTracker == null)
				_searchHandlerAppearanceTracker = CreateSearchHandlerAppearanceTracker();
		}

		protected virtual SearchHandlerAppearanceTracker CreateSearchHandlerAppearanceTracker()
		{
			return new SearchHandlerAppearanceTracker(this, _shellContext);
		}

		#endregion IShellSearchView

View on GitHub (pinned to f377ff1c5e)

Solutions

1. This is typically an internal framework lifecycle issue — update to the latest MAUI version where the ordering may be fixed.
2. If implementing a custom IShellSearchView, ensure LoadView() is called before any code path accesses View.
3. If subclassing ShellSearchView, call base.LoadView() first in any override before accessing View.
4. Avoid accessing the search view's View property from external code; let the Shell framework manage the lifecycle.

// When implementing IShellSearchView, ensure LoadView is called before View
if (_searchButton == null)
    LoadView(searchHandler);
// Now safe to access View

When it happens

Trigger: At line 37: `if (_searchButton == null) throw`. The _searchButton field is set inside LoadView(SearchHandler). Accessing the View property (via the IShellSearchView explicit interface implementation) before the Shell framework calls LoadView triggers this. This is typically an internal lifecycle ordering issue within the Shell search infrastructure, but could be triggered by custom SearchHandler renderers or premature access to the search view.

Common situations: 1) Custom SearchHandler implementation or custom Shell search view that accesses View too early in the lifecycle. 2) MAUI framework version with a lifecycle ordering bug where the Shell calls View before LoadView. 3) Third-party library that hooks into Shell search rendering and accesses the view prematurely. 4) Rare race condition in fragment lifecycle where View is queried before LoadView completes.

Related errors

• Active Shell Item not set. Have you added any Shell Items to
• Content not found for active {ShellItem}. Title: {ShellItem.
• Unexpected navigation type
• DisplayMemberName is not supported. Consider implementing cu
• Shell Content Page is Null

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