SiteMapProviderCollection Class

Definition

Wird von der SiteMap-Klasse zum Verfolgen der SiteMapProvider-Objekte verwendet, die der SiteMap während der Initialisierung der Siteübersicht zur Verfügung stehen.Used by the SiteMap class to track the set of SiteMapProvider objects that are available to the SiteMap during site map initialization. Diese Klasse kann nicht vererbt werden.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
Inheritance
SiteMapProviderCollection

Examples

Im folgenden Codebeispiel wird veranschaulicht, wie das SiteMapProviderCollection Objekt aus dem SiteMap Objekt abgerufen und durchlaufen wird.The following code example demonstrates how to retrieve the SiteMapProviderCollection object from the SiteMap object and iterate through it.

Wenn Sie mehr als nur den für Ihre Website konfigurierten Standardanbieter haben, wird jeder angezeigte Anbieter angezeigt.If you have more than just the default provider configured for your site, you will see each provider that is displayed. Wenn Sie z. b. die Beispiel AccessSiteMapProvider in der Übersicht über die SiteMapProvider-Klasse verwenden, wird die folgende Ausgabe angezeigt.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>

Remarks

Die SiteMapProviderCollection-Klasse ist eine stark typisierte Hashtable Auflistung von SiteMapProvider-Objekten.The SiteMapProviderCollection class is a strongly typed Hashtable collection of SiteMapProvider objects. Zusätzlich zu den beiden Add-Methoden Add(ProviderBase) und Add(SiteMapProvider)unterstützt die SiteMapProviderCollection-Klasse die AddArray-Methode, um ein Array vom Typ SiteMapProviderhinzuzufügen.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.

Der SiteMapProviderCollection wird von der SiteMap-Klasse verwendet, um den Satz von SiteMapProvider Objekten zu verfolgen, die für die SiteMap während der Initialisierung der Site Zuordnung verfügbar sind.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. Das vorhanden sein eines SiteMapProvider in der Anbieter Auflistung bedeutet jedoch nicht notwendigerweise, dass es von einem SiteMap Objekt verwendet wird, sondern nur, dass es für die Verwendung verfügbar ist.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.

Wenn ein SiteMapProvider im SiteMapProviderCollectiongespeichert wird, wird die Name-Eigenschaft als Schlüssel verwendet.When a SiteMapProvider is stored in the SiteMapProviderCollection, the Name property is used as the key.

Constructors

SiteMapProviderCollection()

Initialisiert eine neue Instanz der Klasse SiteMapProviderCollection.Initializes a new instance of the SiteMapProviderCollection class.

Properties

Count

Ruft die Anzahl der Anbieter in der Auflistung ab.Gets the number of providers in the collection.

(Inherited from ProviderCollection)
IsSynchronized

Ruft einen Wert ab, der angibt, ob der Zugriff auf die Auflistung synchronisiert (threadsicher) ist.Gets a value indicating whether access to the collection is synchronized (thread safe).

(Inherited from ProviderCollection)
Item[String]

Ruft ein SiteMapProvider-Objekt mit einem bestimmten Namen aus der Anbieterauflistung ab.Gets a SiteMapProvider object with a specific name from the provider collection.

SyncRoot

Ruft das aktuelle Objekt ab.Gets the current object.

(Inherited from ProviderCollection)

Methods

Add(ProviderBase)

Fügt der Anbieterauflistung mit der SiteMapProvider-Eigenschaft als Schlüssel einen Name hinzu.Adds a SiteMapProvider to the provider collection using the Name property as the key.

Add(SiteMapProvider)

Fügt der Anbieterauflistung mit der SiteMapProvider-Eigenschaft als Schlüssel ein Name-Objekt hinzu.Adds a SiteMapProvider object to the provider collection using the Name property as the key.

AddArray(SiteMapProvider[])

Fügt der Anbieterauflistung mit der SiteMapProvider-Eigenschaft als Schlüssel ein Array von Name-Objekten hinzu.Adds an array of SiteMapProvider objects into the provider collection using the Name properties as keys.

Clear()

Entfernt alle Elemente aus der Collection.Removes all items from the collection.

(Inherited from ProviderCollection)
CopyTo(ProviderBase[], Int32)

Kopiert den Inhalt der Auflistung in das angegebene Array, wobei am angegebenen Index begonnen wird.Copies the contents of the collection to the given array starting at the specified index.

(Inherited from ProviderCollection)
Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator()

Gibt ein Objekt zurück, das die IEnumerator-Schnittstelle implementiert, um die Auflistung zu durchlaufen.Returns an object that implements the IEnumerator interface to iterate through the collection.

(Inherited from ProviderCollection)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(String)

Entfernt einen Anbieter aus der Auflistung.Removes a provider from the collection.

(Inherited from ProviderCollection)
SetReadOnly()

Legt fest, dass die Auflistung schreibgeschützt ist.Sets the collection to be read-only.

(Inherited from ProviderCollection)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explicit Interface Implementations

ICollection.CopyTo(Array, Int32)

Kopiert die Elemente der ProviderCollection in ein Array, beginnend an einem bestimmten Arrayindex.Copies the elements of the ProviderCollection to an array, starting at a particular array index.

(Inherited from ProviderCollection)

Extension Methods

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Applies to

See also