Export (0) Print
Expand All

XmlSiteMapProvider.AddProvider Method

Links a child site map provider to the current provider.

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

'Declaration
Protected Overridable Sub AddProvider ( _
	providerName As String, _
	parentNode As SiteMapNode _
)

Parameters

providerName
Type: System.String

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

parentNode
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.

ExceptionCondition
ArgumentException

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

ArgumentNullException

parentNode is Nothing.

ProviderException

providerName cannot be resolved.

InvalidOperationException

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

-or-

The root node returned by providerName is Nothing.

-or-

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

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft