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 dann mithilfe der AddRange Methode Objekte hinzufügenSiteMapNode. Dies SiteMapNodeCollection ist eine Teilmenge der aktuellen Websitekarte, die nur die ersten beiden hierarchischen Ebenen 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 typierte Auflistung für SiteMapNode Objekte bereit. Es speichert SiteMapNode Objekte intern in einem nullbasierten Array.

Sie können eine SiteMapNodeCollection Auflistung ändern, wenn sie zuerst erstellt wird, und dann die folgenden Methoden verwenden, um Objekte hinzuzufügen, zu kopieren und zu entfernen SiteMapNode :

Verwenden Sie zum Hinzufügen SiteMapNode von Objekten die AddRange AddMethoden , und Insert verwenden Sie diese.
Verwenden Sie die CopyTo Methode, um Objekte zu kopierenSiteMapNode.
Verwenden Sie die Remove Methode, um Objekte zu entfernenSiteMapNode.

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

Verwenden Sie die Eigenschaft, um die IsReadOnly 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 SiteMapNodeCollection Auflistung ein einzelnes SiteMapNode Objekt hinzu.
AddRange(SiteMapNode[])	Fügt der Auflistung ein Array vom Typ SiteMapNode hinzu.
AddRange(SiteMapNodeCollection)	Fügt der aktuellen Auflistung die Knoten in der angegebenen SiteMapNodeCollection 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