SiteMapProviderCollection Klasse

Referenz

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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. Diese Klasse kann nicht vererbt werden.

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

Vererbung: Object

ProviderCollection
SiteMapProviderCollection

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das SiteMapProviderCollection -Objekt aus dem SiteMap -Objekt abgerufen und durchlaufen wird.

Wenn Sie mehr als nur den Standardanbieter für Ihren Standort konfiguriert haben, wird jeder Anbieter angezeigt, der angezeigt wird. Wenn Sie beispielsweise das Beispiel AccessSiteMapProvider in der SiteMapProvider Klassenübersicht verwenden, wird die folgende Ausgabe angezeigt.

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>

Hinweise

Die SiteMapProviderCollection -Klasse ist eine stark typisierte Hashtable Auflistung von SiteMapProvider -Objekten. Zusätzlich zu den beiden Add-Methoden Add(ProviderBase) und Add(SiteMapProvider)unterstützt die SiteMapProviderCollection -Klasse die AddArray -Methode zum Hinzufügen eines Arrays vom Typ SiteMapProvider.

Wird SiteMapProviderCollection von der SiteMap -Klasse verwendet, um den Satz von Objekten nachzuverfolgen, die während der Initialisierung der SiteMapProvider SiteMap Siteübersicht verfügbar sind. Das Vorhandensein eines SiteMapProvider in der Anbieterauflistung bedeutet jedoch nicht unbedingt, dass es von einem SiteMap -Objekt verwendet wird, nur dass es zur Verwendung verfügbar ist.

Wenn ein SiteMapProvider in SiteMapProviderCollectiongespeichert wird, wird die Name -Eigenschaft als Schlüssel verwendet.

Konstruktoren

SiteMapProviderCollection()

Initialisiert eine neue Instanz der SiteMapProviderCollection-Klasse.

Eigenschaften

Count	Ruft die Anzahl der Anbieter in der Auflistung ab. (Geerbt von ProviderCollection)
IsSynchronized	Ruft einen Wert ab, der angibt, ob der Zugriff auf die Auflistung synchronisiert ist (threadsicher). (Geerbt von ProviderCollection)
Item[String]	Ruft ein SiteMapProvider-Objekt mit einem bestimmten Namen aus der Anbieterauflistung ab.
SyncRoot	Ruft das aktuelle Objekt ab. (Geerbt von ProviderCollection)

Methoden

Add(ProviderBase)	Fügt der Anbieterauflistung mit der SiteMapProvider-Eigenschaft als Schlüssel einen Name hinzu.
Add(SiteMapProvider)	Fügt der Anbieterauflistung mit der SiteMapProvider-Eigenschaft als Schlüssel ein Name-Objekt hinzu.
AddArray(SiteMapProvider[])	Fügt der Anbieterauflistung mit der SiteMapProvider-Eigenschaft als Schlüssel ein Array von Name-Objekten hinzu.
Clear()	Entfernt alle Elemente aus der Auflistung. (Geerbt von ProviderCollection)
CopyTo(ProviderBase[], Int32)	Kopiert den Inhalt der Auflistung in das angegebene Array, wobei am angegebenen Index begonnen wird. (Geerbt von ProviderCollection)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetEnumerator()	Gibt ein Objekt zurück, das die IEnumerator-Schnittstelle implementiert, um die Auflistung zu durchlaufen. (Geerbt von ProviderCollection)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Remove(String)	Entfernt einen Anbieter aus der Auflistung. (Geerbt von ProviderCollection)
SetReadOnly()	Legt fest, dass die Auflistung schreibgeschützt ist. (Geerbt von ProviderCollection)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

ICollection.CopyTo(Array, Int32)

Kopiert die Elemente der ProviderCollection beginnend an einem bestimmten Arrayindex in ein Array.

(Geerbt von ProviderCollection)

Erweiterungsmethoden

Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)	Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.

Gilt für:

Freigeben über