SiteMapProviderCollection Класс

Определение

Used by the SiteMap class to track the set of SiteMapProvider objects that are available to the SiteMap during site map initialization.Used by the SiteMap class to track the set of SiteMapProvider objects that are available to the SiteMap during site map initialization. This class cannot be inherited.This class cannot be inherited.

public ref class SiteMapProviderCollection sealed : System::Configuration::Provider::ProviderCollection
public sealed class SiteMapProviderCollection : System.Configuration.Provider.ProviderCollection
type SiteMapProviderCollection = class
    inherit ProviderCollection
Public NotInheritable Class SiteMapProviderCollection
Inherits ProviderCollection
Наследование
SiteMapProviderCollection

Примеры

В следующем примере кода показано, как получить объект SiteMapProviderCollection из объекта SiteMap и выполнить его итерацию.The following code example demonstrates how to retrieve the SiteMapProviderCollection object from the SiteMap object and iterate through it.

Если у вас больше, чем поставщик по умолчанию, настроенный для сайта, вы увидите каждый отображаемый поставщик.If you have more than just the default provider configured for your site, you will see each provider that is displayed. Например, если вы используете образец AccessSiteMapProvider, находящийся в обзоре класса SiteMapProvider, вы увидите следующие выходные данные.For example, if you are using the sample AccessSiteMapProvider found in the SiteMapProvider class overview, you will see the following output.

XmlSiteMapProvider   System.Web.XmlSiteMapProvider  
AccessSiteMapProvider   Samples.AspNet.Controls.AccessSiteMapProvider  
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<SCRIPT runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
    // Navigate the SiteMap built by the default SiteMapProvider.
    Response.Write(SiteMap.RootNode.ToString() + "<BR>");

    Response.Write(SiteMap.RootNode.Url + "<BR>");
    Response.Write(SiteMap.RootNode.Title + "<BR>");

    foreach (SiteMapNode sitemapnode in SiteMap.RootNode.ChildNodes)
    {
        // Iterate through the ChildNodes SiteMapNodesCollection
        // maintained by the RootNode.
        Response.Write(sitemapnode.Url + "<BR>" );
    }

    IEnumerator providers = SiteMap.Providers.GetEnumerator();
    while (providers.MoveNext())
    {
        Response.Write(providers.Current);
        Response.Write("&nbsp;&nbsp;&nbsp;");
        Response.Write("<BR>");
    }
}
</SCRIPT>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<SCRIPT runat="server">
Private Sub Page_Load(Sender As Object, E As EventArgs)

    ' Navigate the SiteMap built by the default SiteMapProvider.
    Response.Write(SiteMap.RootNode.ToString() & "<BR>")

    Response.Write(SiteMap.RootNode.Url & "<BR>")
    Response.Write(SiteMap.RootNode.Title & "<BR>")

    Dim sitemapnode As SiteMapNode
    For Each sitemapnode In SiteMap.RootNode.ChildNodes
        ' Iterate through the ChildNodes SiteMapNodesCollection
        ' maintained by the RootNode.
        Response.Write(sitemapnode.Url & "<BR>" )
    Next

    Dim providers As IDictionaryEnumerator = SiteMap.Providers.GetEnumerator()
    While (providers.MoveNext())
        Response.Write(providers.Current)
        Response.Write("&nbsp;&nbsp;&nbsp;")
        Response.Write("<BR>")
    End While
End Sub ' Page_Load

</SCRIPT>

Комментарии

Класс SiteMapProviderCollection является строго типизированной Hashtable коллекцией объектов SiteMapProvider.The SiteMapProviderCollection class is a strongly typed Hashtable collection of SiteMapProvider objects. В дополнение к двум методам Add, Add(ProviderBase) и Add(SiteMapProvider), класс SiteMapProviderCollection поддерживает метод AddArray для добавления массива типа SiteMapProvider.In addition to the two add methods, Add(ProviderBase) and Add(SiteMapProvider), the SiteMapProviderCollection class supports the AddArray method to add an array of type SiteMapProvider.

SiteMapProviderCollection используется классом SiteMap для наблюдения за набором объектов SiteMapProvider, доступных SiteMap во время инициализации карт сайта.The SiteMapProviderCollection is used by the SiteMap class to track the set of SiteMapProvider objects that are available to the SiteMap during site map initialization. Однако присутствие SiteMapProvider в коллекции поставщиков не обязательно означает, что он используется объектом SiteMap, только он доступен для использования.However, the presence of a SiteMapProvider in the provider collection does not necessarily mean it is used by a SiteMap object, only that it is available for use.

Если SiteMapProvider хранится в SiteMapProviderCollection, в качестве ключа используется свойство Name.When a SiteMapProvider is stored in the SiteMapProviderCollection, the Name property is used as the key.

Конструкторы

SiteMapProviderCollection()

Initializes a new instance of the SiteMapProviderCollection class.Initializes a new instance of the SiteMapProviderCollection class.

Свойства

Count

Возвращает количество поставщиков в коллекции.Gets the number of providers in the collection.

(Унаследовано от ProviderCollection)
IsSynchronized

Возвращает значение, показывающее, синхронизирован ли доступ к коллекции (является ли он потокобезопасным).Gets a value indicating whether access to the collection is synchronized (thread safe).

(Унаследовано от ProviderCollection)
Item[String]

Gets a SiteMapProvider object with a specific name from the provider collection.Gets a SiteMapProvider object with a specific name from the provider collection.

SyncRoot

Возвращает текущий объект.Gets the current object.

(Унаследовано от ProviderCollection)

Методы

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.

AddArray(SiteMapProvider[])

Adds an array of SiteMapProvider objects into the provider collection using the Name properties as keys.Adds an array of SiteMapProvider objects into the provider collection using the Name properties as keys.

Clear()

Удаляет все элементы из коллекции.Removes all items from the collection.

(Унаследовано от ProviderCollection)
CopyTo(ProviderBase[], Int32)

Копирует содержимое коллекции в данный массив, начиная с указанного индекса.Copies the contents of the collection to the given array starting at the specified index.

(Унаследовано от ProviderCollection)
Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetEnumerator()

Возвращает объект, который реализует интерфейс IEnumerator, производящий итерацию по коллекции.Returns an object that implements the IEnumerator interface to iterate through the collection.

(Унаследовано от ProviderCollection)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
Remove(String)

Удаляет поставщик из коллекции.Removes a provider from the collection.

(Унаследовано от ProviderCollection)
SetReadOnly()

Устанавливает статус коллекции "только для чтения".Sets the collection to be read-only.

(Унаследовано от ProviderCollection)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Явные реализации интерфейса

ICollection.CopyTo(Array, Int32)

Копирует элементы ProviderCollection в массив, начиная с определенного индекса массива.Copies the elements of the ProviderCollection to an array, starting at a particular array index.

(Унаследовано от ProviderCollection)

Методы расширения

Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable)

Преобразовывает коллекцию IEnumerable в объект IQueryable.Converts an IEnumerable to an IQueryable.

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

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