XmlSiteMapProvider.AddProvider(String, SiteMapNode) 方法

定義

命名空間:

System.Web

組件:

System.Web.dll

將子網站地圖提供者連結至目前的提供者。

protected:
 virtual void AddProvider(System::String ^ providerName, System::Web::SiteMapNode ^ parentNode);

protected virtual void AddProvider (string providerName, System.Web.SiteMapNode parentNode);

abstract member AddProvider : string * System.Web.SiteMapNode -> unit
override this.AddProvider : string * System.Web.SiteMapNode -> unit

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

參數

providerName

String

目前已在 Providers 中註冊之其中一個 SiteMapProvider 物件的名稱。

parentNode

SiteMapNode

目前網站地圖提供者的網站地圖節點；其下方為新增根節點和子提供者之所有節點的位置。

例外狀況

ArgumentException

parentNode 的 Provider 屬性不會參考目前的提供者。

ArgumentNullException

parentNode 為 null。

ProviderException

無法解析 providerName。

InvalidOperationException

providerName 所使用的網站地圖檔案已在提供者階層架構中使用。

-或- providerName 傳回的根節點為 null。

-或- 父 XmlSiteMapProvider 中已註冊了 providerName 所傳回之根節點的 URL 或索引鍵。

備註

AddProvider方法會連結 providerName 至目前的提供者，做為目前提供者的子系。 的根節點 providerName 會加入目前提供者的階層中，做為的子節點 parentNode 。 因為父提供者 BuildSiteMap 會在上呼叫 providerName 方法，所以可能會擲回方法中所述的例外狀況 BuildSiteMap 。

另請參閱

• RemoveProvider(String)