SiteMapProviderCollection.Add Метод

Определение

Adds a site map provider to the SiteMapProviderCollection collection.Adds a site map provider to the SiteMapProviderCollection collection.

Перегрузки

Add(ProviderBase)

Adds a SiteMapProvider to the provider collection using the Name property as the key.Adds a SiteMapProvider to the provider collection using the Name property as the key.

Add(SiteMapProvider)

Adds a SiteMapProvider object to the provider collection using the Name property as the key.Adds a SiteMapProvider object to the provider collection using the Name property as the key.

Add(ProviderBase)

Adds a SiteMapProvider to the provider collection using the Name property as the key.Adds a SiteMapProvider to the provider collection using the Name property as the key.

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

The SiteMapProvider to add.The SiteMapProvider to add.

Исключения

The Name of the SiteMapProvider is null.The Name of the SiteMapProvider is null.

provider is not an instance of the SiteMapProvider class.provider is not an instance of the SiteMapProvider class.

-or--or- A SiteMapProvider with the same name already exists in the SiteMapProviderCollection.A SiteMapProvider with the same name already exists in the SiteMapProviderCollection.

Комментарии

Объект SiteMapProviderCollection, возвращаемый свойством Providers, доступен только для чтения.The SiteMapProviderCollection object that is returned by the Providers property is read-only. По этой причине нельзя использовать методы Add и AddArray для добавления дополнительных поставщиков программным способом во время выполнения.For this reason, you cannot use the Add and AddArray methods to add additional providers programmatically at run time. Таким образом, методы Add и AddArray используются только в сценариях, где вы вручную создаете объекты поставщика карт сайта и управляете ими с помощью экземпляра класса SiteMapProviderCollection.Therefore, the Add and AddArray methods are used only in scenarios where you manually create site map provider objects and manage them with an instance of the SiteMapProviderCollection class. Метод Add(ProviderBase) проверяет тип указанного поставщика, а затем вызывает метод Add(SiteMapProvider), чтобы добавить его в коллекцию.The Add(ProviderBase) method checks the type of the specified provider, and then calls the Add(SiteMapProvider) method to add it to the collection.

Поскольку класс SiteMap является статическим, все SiteMapProvider, содержащиеся в его Providers коллекции, остаются в течение времени существования веб-приложения.Because the SiteMap class is static, any SiteMapProvider contained in its Providers collection remains for the lifetime of the Web application.

Дополнительно

Add(SiteMapProvider)

Adds a SiteMapProvider object to the provider collection using the Name property as the key.Adds a SiteMapProvider object to the provider collection using the Name property as the key.

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

The SiteMapProvider to add.The SiteMapProvider to add.

Исключения

provider is null.provider is null.

A SiteMapProvider with the same name already exists in the SiteMapProviderCollection.A SiteMapProvider with the same name already exists in the SiteMapProviderCollection.

Комментарии

Объект SiteMapProviderCollection, возвращаемый свойством Providers, доступен только для чтения.The SiteMapProviderCollection object that is returned by the Providers property is read-only. По этой причине нельзя использовать методы Add и AddArray для программного добавления дополнительных поставщиков в SiteMap во время выполнения.For this reason, you cannot use the Add and AddArray methods to programmatically add additional providers to the SiteMap at run time. Таким образом, методы Add и AddArray используются только в сценариях, где вы вручную создаете объекты поставщика карт сайта и управляете ими с помощью экземпляра класса SiteMapProviderCollection.Therefore, the Add and AddArray methods are used only in scenarios where you manually create site map provider objects and manage them with an instance of the SiteMapProviderCollection class. Используйте метод Add, если требуется добавить одну SiteMapProvider в SiteMapProviderCollection.Use the Add method when you want to add a single SiteMapProvider to the SiteMapProviderCollection.

Поскольку класс SiteMap является статическим, все SiteMapProvider, содержащиеся в его Providers коллекции, остаются в течение времени существования веб-приложения.Because the SiteMap class is static, any SiteMapProvider contained in its Providers collection remains for the lifetime of the Web application.

Дополнительно

Применяется к