SiteMapNodeCollection 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.

Stellt eine stark typisierte Auflistung für SiteMapNode-Objekte bereit und implementiert die IHierarchicalEnumerable-Schnittstelle, um das Navigieren in der Auflistung zu unterstützen.

public ref class SiteMapNodeCollection : System::Collections::IList, System::Web::UI::IHierarchicalEnumerable

public class SiteMapNodeCollection : System.Collections.IList, System.Web.UI.IHierarchicalEnumerable

type SiteMapNodeCollection = class
    interface IHierarchicalEnumerable
    interface IList
    interface ICollection
    interface IEnumerable

type SiteMapNodeCollection = class
    interface IHierarchicalEnumerable
    interface IEnumerable
    interface IList
    interface ICollection

Public Class SiteMapNodeCollection
Implements IHierarchicalEnumerable, IList

Vererbung: Object
SiteMapNodeCollection

Implementiert: ICollection IEnumerable IList IHierarchicalEnumerable

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine SiteMapNodeCollection Auflistung erstellen und ihr dann mithilfe der AddRange -Methode Objekte hinzufügenSiteMapNode. ist SiteMapNodeCollection eine Teilmenge der aktuellen Siteübersicht, die nur die ersten beiden Hierarchieebenen anzeigt.


// Create a SiteMapNodeCollection with all the nodes
// from the first two hierarchical levels of the current
// site map.
SiteMapNodeCollection baseCollection =
    new SiteMapNodeCollection(SiteMap.RootNode);

SiteMapNodeCollection childCollection =
    SiteMap.RootNode.ChildNodes;

baseCollection.AddRange(childCollection);

Response.Write( "<BR>Derived SiteMapNodeCollection.<BR><HR><BR>");
foreach (SiteMapNode node in baseCollection) {
    Response.Write( node.Title + "<BR>");
}


' Create a SiteMapNodeCollection with all the nodes
' from the first two hierarchical levels of the current
' site map.
Dim baseCollection As SiteMapNodeCollection
baseCollection = New SiteMapNodeCollection(SiteMap.RootNode)

Dim childCollection As SiteMapNodeCollection = SiteMap.RootNode.ChildNodes

baseCollection.AddRange(childCollection)

Response.Write( "<BR>Derived SiteMapNodeCollection.<BR><HR><BR>")

For Each node In baseCollection
    Response.Write( node.Title + "<BR>")
Next

Hinweise

Die SiteMapNodeCollection -Klasse stellt eine stark typisierte Auflistung für SiteMapNode -Objekte bereit. Objekte werden intern in einem nullbasierten Array gespeichert SiteMapNode .

Sie können eine SiteMapNodeCollection Auflistung beim ersten Erstellen ändern und dann die folgenden Methoden verwenden, um Objekte hinzuzufügen, zu kopieren und zu entfernen SiteMapNode :

Verwenden Sie zum Hinzufügen von SiteMapNode Objekten die AddMethoden , AddRangeund Insert .
Verwenden Sie zum Kopieren SiteMapNode von Objekten die CopyTo -Methode.
Verwenden Sie die Remove -Methode, um Objekte zu entfernenSiteMapNode.

Sie können mit der statischen Methode einen schreibgeschützten SiteMapNodeCollection ReadOnly -Wert erstellen, der das Hinzufügen, Kopieren oder Entfernen SiteMapNode von Objekten nicht zulässt. Die SiteMapNodeCollection Auflistungen, die von den SiteMapNode.GetAllNodes Methoden und GetChildren zurückgegeben werden, sind schreibgeschützt, ebenso wie die , die SiteMapNodeCollection zurückgegeben wird, wenn auf die ChildNodes -Eigenschaft für ein SiteMapNode Objekt zugegriffen wird, das von einem Anbieter zurückgegeben wird. Eine NotSupportedException Ausnahme wird ausgelöst, wenn Sie versuchen, einen schreibgeschützten SiteMapNodeCollection Wert durch Festlegen der Standardindexereigenschaft oder mithilfe einer der folgenden Methoden zu ändern:

Verwenden Sie die IsReadOnly -Eigenschaft, um die Auflistung zu überprüfen, bevor Sie eine der Methoden in der vorherigen Liste aufrufen.

Konstruktoren

SiteMapNodeCollection()	Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse, bei der es sich um die Standardinstanz handelt.
SiteMapNodeCollection(Int32)	Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse mit der angegebenen anfänglichen Kapazität.
SiteMapNodeCollection(SiteMapNode)	Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse und fügt der SiteMapNode-Eigenschaft das InnerList-Objekt für die Auflistung hinzu.
SiteMapNodeCollection(SiteMapNode[])	Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse und fügt der SiteMapNode-Eigenschaft das Array vom Typ InnerList für die Auflistung hinzu.
SiteMapNodeCollection(SiteMapNodeCollection)	Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse und fügt der SiteMapNodeCollection-Eigenschaft alle Listenelemente der angegebenen InnerList-Auflistung hinzu.

Eigenschaften

Count	Ruft die Anzahl der Elemente in der Auflistung ab.
IsFixedSize	Ruft einen booleschen Wert ab, der angibt, ob der Auflistung Knoten hinzugefügt oder Knoten aus der Auflistung entfernt werden können.
IsReadOnly	Ruft einen booleschen Wert ab, der angibt, ob die Auflistung schreibgeschützt ist.
IsSynchronized	Ruft einen booleschen Wert ab, der angibt, ob der Zugriff auf die Auflistung synchronisiert (threadsicher) ist.
Item[Int32]	Ruft das SiteMapNode-Objekt am angegebenen Index in der Auflistung ab oder legt dieses fest.
SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf die Auflistung synchronisiert werden kann.

Methoden

Add(SiteMapNode)	Fügt der Auflistung ein einzelnes SiteMapNode SiteMapNodeCollection -Objekt hinzu.
AddRange(SiteMapNode[])	Fügt der Auflistung ein Array vom Typ SiteMapNode hinzu.
AddRange(SiteMapNodeCollection)	Fügt die Knoten im angegebenen SiteMapNodeCollection der aktuellen Auflistung hinzu.
Clear()	Entfernt alle Elemente aus der Auflistung.
Contains(SiteMapNode)	Ermittelt, ob die Auflistung ein bestimmtes SiteMapNode-Objekt enthält.
CopyTo(SiteMapNode[], Int32)	Kopiert die gesamte Auflistung ab dem angegebenen Index des Zielarrays in ein kompatibles, eindimensionales Array.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetDataSourceView(SiteMapDataSource, String)	Ruft das SiteMapDataSourceView-Objekt ab, das den Knoten in der aktuellen Auflistung zugeordnet ist.
GetEnumerator()	Ruft einen Verweis auf ein Enumeratorobjekt ab, das zum Durchlaufen der Auflistung verwendet wird.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetHierarchicalDataSourceView()	Ruft das SiteMapHierarchicalDataSourceView-Objekt ab, das den Knoten in der aktuellen Auflistung zugeordnet ist.
GetHierarchyData(Object)	Gibt ein hierarchisches Datenelement für das angegebene aufgelistete Element zurück.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IndexOf(SiteMapNode)	Sucht nach dem angegebenen SiteMapNode-Objekt und gibt danach den nullbasierten Index des ersten Vorkommens innerhalb der gesamten Auflistung zurück.
Insert(Int32, SiteMapNode)	Fügt das angegebene SiteMapNode-Objekt am angegebenen Index in die Auflistung ein.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnValidate(Object)	Führt zusätzliche benutzerdefinierte Prozesse beim Validieren eines Werts aus.
ReadOnly(SiteMapNodeCollection)	Gibt eine schreibgeschützte Auflistung zurück, die die Knoten in der angegebenen SiteMapNodeCollection-Auflistung enthält.
Remove(SiteMapNode)	Entfernt das angegebene SiteMapNode-Objekt aus der Auflistung.
RemoveAt(Int32)	Entfernt das SiteMapNode -Objekt am angegebenen Index der SiteMapNodeCollection Auflistung.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

ICollection.CopyTo(Array, Int32)	Kopiert die Elemente der ICollection-Schnittstelle in ein Array, beginnend an einem bestimmten Arrayindex. Diese Klasse kann nicht vererbt werden.
ICollection.Count	Ruft die Anzahl der Elemente ab, die in der ICollection-Schnittstelle enthalten sind. Diese Klasse kann nicht vererbt werden.
ICollection.IsSynchronized	Ruft einen `Boolean`-Wert ab, der angibt, ob der Zugriff auf die ICollection-Schnittstelle synchronisiert (threadsicher) ist. Diese Klasse kann nicht vererbt werden.
ICollection.SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf die ICollection-Schnittstelle synchronisiert werden kann. Diese Klasse kann nicht vererbt werden.
IEnumerable.GetEnumerator()	Gibt einen Enumerator zurück, der eine Auflistung durchläuft. Eine Beschreibung dieses Elements finden Sie unter GetEnumerator().
IHierarchicalEnumerable.GetHierarchyData(Object)	Gibt ein hierarchisches Datenelement für das angegebene aufgelistete Element zurück. Eine Beschreibung dieses Elements finden Sie unter GetHierarchyData(Object).
IList.Add(Object)	Fügt der Auflistung in der IList-Schnittstelle ein Element hinzu. Eine Beschreibung dieses Elements finden Sie unter Add(Object).
IList.Clear()	Entfernt alle Elemente aus der Auflistung in der IList-Schnittstelle. Eine Beschreibung dieses Elements finden Sie unter Clear().
IList.Contains(Object)	Bestimmt, ob die Auflistung in der IList-Schnittstelle den angegebenen booleschen Wert enthält.
IList.IndexOf(Object)	Bestimmt den Index des bestimmten Elements in der Auflistung, das von der IList-Schnittstelle zurückgegeben wird. Eine Beschreibung dieses Elements finden Sie unter IndexOf(Object).
IList.Insert(Int32, Object)	Fügt ein Element in die Auflistung in der IList-Schnittstelle am angegebenen Index ein. Eine Beschreibung dieses Elements finden Sie unter Insert(Int32, Object).
IList.IsFixedSize	Ruft einen `Boolean`-Wert ab, der angibt, ob die Auflistung eine feste Größe aufweist. Eine Beschreibung dieses Elements finden Sie unter IsFixedSize.
IList.IsReadOnly	Ruft einen `Boolean`-Wert ab, der angibt, ob die Auflistung schreibgeschützt ist. Eine Beschreibung dieses Elements finden Sie unter IsReadOnly.
IList.Item[Int32]	Ruft das IList-Element am angegebenen Index ab.
IList.Remove(Object)	Entfernt das erste Vorkommen eines bestimmten Objekts aus der Auflistung in der IList-Schnittstelle. Eine Beschreibung dieses Elements finden Sie unter Remove(Object).
IList.RemoveAt(Int32)	Entfernt das IList-Element am angegebenen Index. Eine Beschreibung dieses Elements finden Sie unter RemoveAt(Int32).

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:

Teilen über