SiteMapProviderCollection.Add 方法

定義

命名空間:

System.Web

組件:

System.Web.dll

將網站導覽提供者加入至 SiteMapProviderCollection 集合。

多載

Add(ProviderBase)	使用 SiteMapProvider 屬性做為索引鍵，將 Name 加入至提供者集合。
Add(SiteMapProvider)	使用 SiteMapProvider 屬性做為索引鍵，將 Name 物件加入至提供者集合。

Add(ProviderBase)

使用 SiteMapProvider 屬性做為索引鍵，將 Name 加入至提供者集合。

public:
 override void Add(System::Configuration::Provider::ProviderBase ^ provider);

public override void Add (System.Configuration.Provider.ProviderBase provider);

override this.Add : System.Configuration.Provider.ProviderBase -> unit

Public Overrides Sub Add (provider As ProviderBase)

參數

provider

ProviderBase

要加入的 SiteMapProvider。

例外狀況

ArgumentNullException

Name 的 SiteMapProvider 為 null。

ArgumentException

provider 不是 SiteMapProvider 類別的執行個體。

-或- 具有相同名稱的 SiteMapProvider 已經存在於 SiteMapProviderCollection 中。

NotSupportedException

SiteMapProviderCollection 為唯讀。

備註

SiteMapProviderCollection屬性所 Providers 傳回的物件是唯讀的。 因此，您無法使用 Add 和 AddArray 方法，在執行時間以程式設計方式新增其他提供者。 因此， Add 和 AddArray 方法只會用於手動建立網站地圖提供者物件的案例，並使用 類別的 SiteMapProviderCollection 實例加以管理。 方法 Add(ProviderBase) 會檢查指定提供者的類型，然後呼叫 Add(SiteMapProvider) 方法，將它新增至集合。

因為 類別 SiteMap 是靜態的， SiteMapProvider 所以其 Providers 集合中的任何都包含在 Web 應用程式的存留期內。

另請參閱

• AddArray(SiteMapProvider[])

Add(SiteMapProvider)

使用 SiteMapProvider 屬性做為索引鍵，將 Name 物件加入至提供者集合。

public:
 void Add(System::Web::SiteMapProvider ^ provider);

public void Add (System.Web.SiteMapProvider provider);

override this.Add : System.Web.SiteMapProvider -> unit

Public Sub Add (provider As SiteMapProvider)

參數

provider

SiteMapProvider

要加入的 SiteMapProvider。

例外狀況

ArgumentNullException

provider 為 null。

NotSupportedException

SiteMapProviderCollection 為唯讀。

ArgumentException

具有相同名稱的 SiteMapProvider 已經存在於 SiteMapProviderCollection 中。

備註

SiteMapProviderCollection屬性所 Providers 傳回的物件是唯讀的。 基於這個理由，您無法使用 Add 和 AddArray 方法，以程式設計方式在執行時間將其他提供者新增至 SiteMap 。 因此， Add 和 AddArray 方法只會用於手動建立網站地圖提供者物件的案例，並使用 類別的 SiteMapProviderCollection 實例加以管理。 Add當您想要將單 SiteMapProvider 一加入 至 時， SiteMapProviderCollection 請使用 方法。

因為 類別 SiteMap 是靜態的， SiteMapProvider 所以其 Providers 集合中的任何都包含在 Web 應用程式的存留期內。

另請參閱

• Add(ProviderBase)