SiteMapNodeCollection SiteMapNodeCollection SiteMapNodeCollection SiteMapNodeCollection Class

Definition

Stellt eine stark typisierte Auflistung für SiteMapNode-Objekte bereit und implementiert die IHierarchicalEnumerable-Schnittstelle, um das Navigieren in der Auflistung zu unterstützen.Provides a strongly typed collection for SiteMapNode objects and implements the IHierarchicalEnumerable interface to support navigating through the collection.

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 IEnumerable
    interface IList
    interface ICollection
Public Class SiteMapNodeCollection
Implements IHierarchicalEnumerable, IList
Vererbung
SiteMapNodeCollectionSiteMapNodeCollectionSiteMapNodeCollectionSiteMapNodeCollection
Implementiert

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie zum Erstellen einer SiteMapNodeCollection -Auflistung, und fügen Sie dann SiteMapNode -Objekte mithilfe der AddRange Methode.The following code example demonstrates how to create a SiteMapNodeCollection collection, and then add SiteMapNode objects to it using the AddRange method. Die SiteMapNodeCollection ist eine Teilmenge des die aktuelle sitezuordnung und zeigt nur die ersten beiden hierarchischen Ebenen.The SiteMapNodeCollection is a subset of the current site map, showing only the first two hierarchical levels.


// 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.The SiteMapNodeCollection class provides a strongly typed collection for SiteMapNode objects. Sie speichert SiteMapNode Objekte intern in einem nullbasierten Array.It stores SiteMapNode objects internally in a zero-based array.

Sie können eine SiteMapNodeCollection Auflistung bei zuerst erstellt und dann die folgenden Methoden zum Hinzufügen, kopieren und Entfernen von SiteMapNode Objekte:You can modify a SiteMapNodeCollection collection when it is first created, and then use the following methods to add, copy, and remove SiteMapNode objects:

Sie können ein schreibgeschütztes erstellen SiteMapNodeCollection, die lässt nicht zu hinzufügen, kopieren und Entfernen von SiteMapNode Objekte mithilfe der statischen ReadOnly Methode.You can create a read-only SiteMapNodeCollection, which does not permit adding, copying, nor removing SiteMapNode objects, by using the static ReadOnly method. Die SiteMapNodeCollection Sammlungen, die von zurückgegeben werden die SiteMapNode.GetAllNodes und GetChildren Methoden sind schreibgeschützt, wie die SiteMapNodeCollection , die zurückgegeben wird, wenn die ChildNodes -Eigenschaft wird zugegriffen, auf eine SiteMapNode -Objekt, das von zurückgegeben wird ein Anbieter.The SiteMapNodeCollection collections that are returned by the SiteMapNode.GetAllNodes and GetChildren methods are read-only, as is the SiteMapNodeCollection that is returned when the ChildNodes property is accessed on a SiteMapNode object that is returned from a provider. Ein NotSupportedException Ausnahme wird ausgelöst, wenn Sie versuchen, eine schreibgeschützte ändern SiteMapNodeCollection durch Festlegen der Standardindexereigenschaft oder indem Sie eine der folgenden Methoden:A NotSupportedException exception is thrown, if you attempt to modify a read-only SiteMapNodeCollection by setting the default indexer property or by using any of the following methods:

Verwenden der IsReadOnly -Eigenschaft die Auflistung vor dem Aufrufen der Methoden in der vorangehenden Liste überprüft.Use the IsReadOnly property to check the collection before calling any of the methods in the preceding list.

Konstruktoren

SiteMapNodeCollection() SiteMapNodeCollection() SiteMapNodeCollection() SiteMapNodeCollection()

Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse, bei der es sich um die Standardinstanz handelt.Initializes a new instance of the SiteMapNodeCollection class, which is the default instance.

SiteMapNodeCollection(Int32) SiteMapNodeCollection(Int32) SiteMapNodeCollection(Int32) SiteMapNodeCollection(Int32)

Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse mit der angegebenen anfänglichen Kapazität.Initializes a new instance of the SiteMapNodeCollection class with the specified initial capacity.

SiteMapNodeCollection(SiteMapNode) SiteMapNodeCollection(SiteMapNode) SiteMapNodeCollection(SiteMapNode) SiteMapNodeCollection(SiteMapNode)

Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse und fügt der SiteMapNode-Eigenschaft das InnerList-Objekt für die Auflistung hinzu.Initializes a new instance of the SiteMapNodeCollection class and adds the SiteMapNode object to the InnerList property for the collection.

SiteMapNodeCollection(SiteMapNodeCollection) SiteMapNodeCollection(SiteMapNodeCollection) SiteMapNodeCollection(SiteMapNodeCollection) SiteMapNodeCollection(SiteMapNodeCollection)

Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse und fügt der SiteMapNodeCollection-Eigenschaft alle Listenelemente der angegebenen InnerList-Auflistung hinzu.Initializes a new instance of the SiteMapNodeCollection class and adds all the list items of the specified SiteMapNodeCollection collection to the InnerList property for the collection.

SiteMapNodeCollection(SiteMapNode[]) SiteMapNodeCollection(SiteMapNode[]) SiteMapNodeCollection(SiteMapNode[]) 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.Initializes a new instance of the SiteMapNodeCollection class and adds the array of type SiteMapNode to the InnerList property for the collection.

Eigenschaften

Count Count Count Count

Ruft die Anzahl der Elemente in der Auflistung ab.Gets the number of elements contained in the collection.

IsFixedSize IsFixedSize IsFixedSize IsFixedSize

Ruft einen booleschen Wert ab, der angibt, ob der Auflistung Knoten hinzugefügt oder Knoten aus der Auflistung entfernt werden können.Gets a Boolean value indicating whether nodes can be added to or subtracted from the collection.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Ruft einen booleschen Wert ab, der angibt, ob die Auflistung schreibgeschützt ist.Gets a Boolean value indicating whether the collection is read-only.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

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

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ruft das SiteMapNode-Objekt am angegebenen Index in der Auflistung ab oder legt dieses fest.Gets or sets the SiteMapNode object at the specified index in the collection.

SyncRoot SyncRoot SyncRoot SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf die Auflistung synchronisiert werden kann.Gets an object that can be used to synchronize access to the collection.

Methoden

Add(SiteMapNode) Add(SiteMapNode) Add(SiteMapNode) Add(SiteMapNode)

Fügt der Auflistung ein einzelnes SiteMapNode-Objekt hinzu.Adds a single SiteMapNode object to the collection.

AddRange(SiteMapNodeCollection) AddRange(SiteMapNodeCollection) AddRange(SiteMapNodeCollection) AddRange(SiteMapNodeCollection)

Fügt der aktuellen Auflistung die Knoten in der angegebenen SiteMapNodeCollection hinzu.Adds the nodes in the specified SiteMapNodeCollection to the current collection.

AddRange(SiteMapNode[]) AddRange(SiteMapNode[]) AddRange(SiteMapNode[]) AddRange(SiteMapNode[])

Fügt der Auflistung ein Array vom Typ SiteMapNode hinzu.Adds an array of type SiteMapNode to the collection.

Clear() Clear() Clear() Clear()

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

Contains(SiteMapNode) Contains(SiteMapNode) Contains(SiteMapNode) Contains(SiteMapNode)

Ermittelt, ob die Auflistung ein bestimmtes SiteMapNode-Objekt enthält.Determines whether the collection contains a specific SiteMapNode object.

CopyTo(SiteMapNode[], Int32) CopyTo(SiteMapNode[], Int32) CopyTo(SiteMapNode[], Int32) CopyTo(SiteMapNode[], Int32)

Kopiert die gesamte Auflistung in ein kompatibles eindimensionales Array, wobei am angegebenen Index im Zielarray begonnen wird.Copies the entire collection to a compatible one-dimensional array, starting at the specified index of the target array.

Equals(Object) Equals(Object) Equals(Object) 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)
GetDataSourceView(SiteMapDataSource, String) GetDataSourceView(SiteMapDataSource, String) GetDataSourceView(SiteMapDataSource, String) GetDataSourceView(SiteMapDataSource, String)

Ruft das SiteMapDataSourceView-Objekt ab, das den Knoten in der aktuellen Auflistung zugeordnet ist.Retrieves the SiteMapDataSourceView object that is associated with the nodes in the current collection.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Ruft einen Verweis auf ein Enumeratorobjekt ab, das zum Durchlaufen der Auflistung verwendet wird.Retrieves a reference to an enumerator object, which is used to iterate over the collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetHierarchicalDataSourceView() GetHierarchicalDataSourceView() GetHierarchicalDataSourceView() GetHierarchicalDataSourceView()

Ruft das SiteMapHierarchicalDataSourceView-Objekt ab, das den Knoten in der aktuellen Auflistung zugeordnet ist.Retrieves the SiteMapHierarchicalDataSourceView object that is associated with the nodes in the current collection.

GetHierarchyData(Object) GetHierarchyData(Object) GetHierarchyData(Object) GetHierarchyData(Object)

Gibt ein hierarchisches Datenelement für das angegebene aufgelistete Element zurück.Returns a hierarchical data item for the specified enumerated item.

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IndexOf(SiteMapNode) IndexOf(SiteMapNode) IndexOf(SiteMapNode) IndexOf(SiteMapNode)

Sucht nach dem angegebenen SiteMapNode-Objekt und gibt danach den nullbasierten Index des ersten Vorkommens innerhalb der gesamten Auflistung zurück.Searches for the specified SiteMapNode object, and then returns the zero-based index of the first occurrence within the entire collection.

Insert(Int32, SiteMapNode) Insert(Int32, SiteMapNode) Insert(Int32, SiteMapNode) Insert(Int32, SiteMapNode)

Fügt das angegebene SiteMapNode-Objekt am angegebenen Index in die Auflistung ein.Inserts the specified SiteMapNode object into the collection at the specified index.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnValidate(Object) OnValidate(Object) OnValidate(Object) OnValidate(Object)

Führt zusätzliche benutzerdefinierte Prozesse beim Validieren eines Werts aus.Performs additional custom processes when validating a value.

ReadOnly(SiteMapNodeCollection) ReadOnly(SiteMapNodeCollection) ReadOnly(SiteMapNodeCollection) ReadOnly(SiteMapNodeCollection)

Gibt eine schreibgeschützte Auflistung zurück, die die Knoten in der angegebenen SiteMapNodeCollection-Auflistung enthält.Returns a read-only collection that contains the nodes in the specified SiteMapNodeCollection collection.

Remove(SiteMapNode) Remove(SiteMapNode) Remove(SiteMapNode) Remove(SiteMapNode)

Entfernt das angegebene SiteMapNode-Objekt aus der Auflistung.Removes the specified SiteMapNode object from the collection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Entfernt das SiteMapNode-Objekt am angegebenen Index der Auflistung.Removes the SiteMapNode object at the specified index of the collection.

ToString() ToString() ToString() ToString()

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

(Inherited from Object)

Explizite Schnittstellenimplementierungen

ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)

Kopiert die Elemente der ICollection-Schnittstelle in ein Array, beginnend an einem bestimmten Arrayindex.Copies the elements of the ICollection interface to an array, starting at a particular array index. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

ICollection.Count ICollection.Count ICollection.Count ICollection.Count

Ruft die Anzahl der Elemente ab, die in der ICollection-Schnittstelle enthalten sind.Gets the number of elements that are contained in the ICollection interface. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

Ruft einen Boolean-Wert ab, der angibt, ob der Zugriff auf die ICollection-Schnittstelle synchronisiert (threadsicher) ist.Gets a Boolean value indicating whether access to the ICollection interface is synchronized (thread safe). Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf die ICollection-Schnittstelle synchronisiert werden kann.Gets an object that can be used to synchronize access to the ICollection interface. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Gibt einen Enumerator zurück, der eine Auflistung durchläuft.Returns an enumerator that iterates through a collection. Eine Beschreibung dieses Members finden Sie unter GetEnumerator().For a description of this member, see GetEnumerator().

IHierarchicalEnumerable.GetHierarchyData(Object) IHierarchicalEnumerable.GetHierarchyData(Object) IHierarchicalEnumerable.GetHierarchyData(Object) IHierarchicalEnumerable.GetHierarchyData(Object)

Gibt ein hierarchisches Datenelement für das angegebene aufgelistete Element zurück.Returns a hierarchical data item for the specified enumerated item. Eine Beschreibung dieses Members finden Sie unter GetHierarchyData(Object).For a description of this member, see GetHierarchyData(Object).

IList.Add(Object) IList.Add(Object) IList.Add(Object) IList.Add(Object)

Fügt der Auflistung in der IList-Schnittstelle ein Element hinzu.Adds an item to the collection in the IList interface. Eine Beschreibung dieses Members finden Sie unter Add(Object).For a description of this member, see Add(Object).

IList.Clear() IList.Clear() IList.Clear() IList.Clear()

Entfernt alle Elemente aus der Auflistung in der IList-Schnittstelle.Removes all items from the collection in the IList interface. Eine Beschreibung dieses Elements finden Sie unter Clear().For a description of this member, see Clear().

IList.Contains(Object) IList.Contains(Object) IList.Contains(Object) IList.Contains(Object)

Bestimmt, ob die Auflistung in der IList-Schnittstelle den angegebenen booleschen Wert enthält.Determines whether the collection in the IList interface contains the specified Boolean value.

IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object)

Bestimmt den Index des bestimmten Elements in der Auflistung, das von der IList-Schnittstelle zurückgegeben wird.Determines the index of the specific item in the collection that is returned by the IList interface. Eine Beschreibung dieses Members finden Sie unter IndexOf(Object).For a description of this member, see IndexOf(Object).

IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object)

Fügt ein Element in die Auflistung in der IList-Schnittstelle am angegebenen Index ein.Inserts an item into the collection in the IList interface at the specified index. Eine Beschreibung dieses Members finden Sie unter Insert(Int32, Object).For a description of this member, see Insert(Int32, Object).

IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize

Ruft einen Boolean-Wert ab, der angibt, ob die Auflistung eine feste Größe aufweist.Gets a Boolean value indicating whether the collection has a fixed size. Eine Beschreibung dieses Elements finden Sie unter IsFixedSize.For a description of this member, see IsFixedSize.

IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly

Ruft einen Boolean-Wert ab, der angibt, ob die Auflistung schreibgeschützt ist.Gets a Boolean value indicating whether the collection is read-only. Eine Beschreibung dieses Members finden Sie unter IsReadOnly.For a description of this member, see IsReadOnly.

IList.Item[Int32] IList.Item[Int32] IList.Item[Int32] IList.Item[Int32]

Ruft das IList-Element am angegebenen Index ab.Gets the IList element at the specified index.

IList.Remove(Object) IList.Remove(Object) IList.Remove(Object) IList.Remove(Object)

Entfernt das erste Vorkommen eines bestimmten Objekts aus der Auflistung in der IList-Schnittstelle.Removes the first occurrence of a specified object from the collection in the IList interface. Eine Beschreibung dieses Members finden Sie unter Remove(Object).For a description of this member, see Remove(Object).

IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32)

Entfernt das IList-Element am angegebenen Index.Removes the IList item at the specified index. Eine Beschreibung dieses Members finden Sie unter RemoveAt(Int32).For a description of this member, see RemoveAt(Int32).

Extension Methods

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) 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) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

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

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

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

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Konvertiert eine IEnumerable auf eine IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für:

Siehe auch