SiteMapNodeCollection Klasse

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 typierte Auflistung für SiteMapNode Objekte bereit und implementiert die IHierarchicalEnumerable Schnittstelle zur Unterstützung der Navigation durch die Auflistung.

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 eine SiteMapNodeCollection Auflistung erstellt und anschließend SiteMapNode mithilfe der AddRange Methode Objekte hinzugefügt werden. 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 Objekte bereit SiteMapNode . Es speichert SiteMapNode Objekte intern in einem nullbasierten Array.

Sie können eine SiteMapNodeCollection Auflistung ändern, wenn sie zum ersten Mal erstellt wird, 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 Methoden , AddRangeund Insert verwenden Sie dieseAdd.
Verwenden Sie die CopyTo Methode, um Objekte zu kopierenSiteMapNode.
Verwenden Sie die Remove Methode, um Objekte zu entfernenSiteMapNode.

Sie können mithilfe der statischen ReadOnly Methode eine schreibgeschützte SiteMapNodeCollectionMethode erstellen, die das Hinzufügen, Kopieren oder Entfernen SiteMapNode von Objekten nicht zulässt. Die SiteMapNodeCollection Auflistungen, die von den SiteMapNode.GetAllNodes Methoden GetChildren zurückgegeben werden, sind schreibgeschützt, wie 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, eine schreibgeschützte SiteMapNodeCollection Eigenschaft 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

Name	Beschreibung
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 Anfangskapazität.
SiteMapNodeCollection(SiteMapNode)	Initialisiert eine neue Instanz der SiteMapNodeCollection Klasse und fügt das SiteMapNode Objekt der InnerList Eigenschaft für die Auflistung hinzu.
SiteMapNodeCollection(SiteMapNode[])	Initialisiert eine neue Instanz der SiteMapNodeCollection Klasse und fügt das Array des Typs SiteMapNode der InnerList Eigenschaft für die Auflistung hinzu.
SiteMapNodeCollection(SiteMapNodeCollection)	Initialisiert eine neue Instanz der SiteMapNodeCollection Klasse und fügt alle Listenelemente der angegebenen SiteMapNodeCollection Auflistung der InnerList Eigenschaft für die Auflistung hinzu.

Eigenschaften

Name	Beschreibung
Count	Ruft die Anzahl der In der Auflistung enthaltenen Elemente ab.
IsFixedSize	Ruft einen booleschen Wert ab, der angibt, ob Knoten der Auflistung hinzugefügt oder subtrahiert 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 wird (Threadsicher).
Item[Int32]	Dient zum Abrufen oder Festlegen des SiteMapNode Objekts am angegebenen Index in der Auflistung.
SyncRoot	Ruft ein Objekt ab, das zum Synchronisieren des Zugriffs auf die Auflistung verwendet werden kann.

Methoden

Name	Beschreibung
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 Auflistung hinzu.
Clear()	Entfernt alle Elemente aus der Auflistung.
Contains(SiteMapNode)	Bestimmt, ob die Auflistung ein bestimmtes SiteMapNode Objekt enthält.
CopyTo(SiteMapNode[], Int32)	Kopiert die gesamte Auflistung in ein kompatibles eindimensionales Array, beginnend am angegebenen Index des Zielarrays.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (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 Enumerationsobjekt ab, das zum Durchlaufen der Auflistung verwendet wird.
GetHashCode()	Dient 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 aufgezählte Element zurück.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
IndexOf(SiteMapNode)	Sucht nach dem angegebenen SiteMapNode Objekt und gibt dann den nullbasierten Index des ersten Vorkommens innerhalb der gesamten Auflistung zurück.
Insert(Int32, SiteMapNode)	Fügt das angegebene SiteMapNode Objekt in die Auflistung am angegebenen Index ein.
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnValidate(Object)	Führt beim Überprüfen eines Werts zusätzliche benutzerdefinierte Prozesse 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

Name	Beschreibung
ICollection.CopyTo(Array, Int32)	Kopiert die Elemente der ICollection Schnittstelle in ein Array, beginnend bei 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 wird (Threadsicher). Diese Klasse kann nicht vererbt werden.
ICollection.SyncRoot	Ruft ein Objekt ab, das zum Synchronisieren des Zugriffs auf die ICollection Schnittstelle verwendet werden kann. Diese Klasse kann nicht vererbt werden.
IEnumerable.GetEnumerator()	Gibt einen Enumerator zurück, der eine Auflistung durchläuft. Eine Beschreibung dieses Mitglieds finden Sie unter GetEnumerator().
IHierarchicalEnumerable.GetHierarchyData(Object)	Gibt ein hierarchisches Datenelement für das angegebene aufgezählte Element zurück. Eine Beschreibung dieses Mitglieds finden Sie unter GetHierarchyData(Object).
IList.Add(Object)	Fügt der Auflistung in der IList Schnittstelle ein Element hinzu. Eine Beschreibung dieses Mitglieds finden Sie unter Add(Object).
IList.Clear()	Entfernt alle Elemente aus der Auflistung in der IList Schnittstelle. Eine Beschreibung dieses Mitglieds 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 spezifischen Elements in der Auflistung, die von der IList Schnittstelle zurückgegeben wird. Eine Beschreibung dieses Mitglieds 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 Mitglieds 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 Mitglieds finden Sie unter IsFixedSize.
IList.IsReadOnly	Ruft einen `Boolean` Wert ab, der angibt, ob die Auflistung schreibgeschützt ist. Eine Beschreibung dieses Mitglieds finden Sie unter IsReadOnly.
IList.Item[Int32]	Ruft das IList Element am angegebenen Index ab.
IList.Remove(Object)	Entfernt das erste Vorkommen eines angegebenen Objekts aus der Auflistung in der IList Schnittstelle. Eine Beschreibung dieses Mitglieds finden Sie unter Remove(Object).
IList.RemoveAt(Int32)	Entfernt das IList Element am angegebenen Index. Eine Beschreibung dieses Mitglieds finden Sie unter RemoveAt(Int32).

Erweiterungsmethoden

Name	Beschreibung
AsParallel(IEnumerable)	Aktiviert die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Wandelt eine IEnumerable in eine IQueryableum.
Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um.
OfType<TResult>(IEnumerable)	Filtert die Elemente einer IEnumerable basierend auf einem angegebenen Typ.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?