XmlSiteMapProvider::AddProvider Method (String^, SiteMapNode^)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Links a child site map provider to the current provider.

Namespace:   System.Web
Assembly:  System.Web (in System.Web.dll)

virtual void AddProvider(
	String^ providerName,
	SiteMapNode^ parentNode


Type: System::String^

The name of one of the SiteMapProvider objects currently registered in the Providers.

Type: System.Web::SiteMapNode^

A site map node of the current site map provider under which the root node and all nodes of the child provider is added.

Exception Condition

The Provider property of the parentNode does not reference the current provider.


parentNode is null.


providerName cannot be resolved.


The site map file used by providerName is already in use within the provider hierarchy.


The root node returned by providerName is null.


The root node returned by providerName has a URL or key that is already registered with the parent XmlSiteMapProvider.

The AddProvider method links providerName to the current provider as a child of the current provider. The root node of providerName is added to the hierarchy for the current provider as a child node of parentNode. Because the parent provider calls the BuildSiteMap method on providerName, the exceptions that are described in the BuildSiteMap method might be thrown.

.NET Framework
Available since 2.0
Return to top