SiteMapNodeCollection.AddRange Method

Definition

Fügt der Auflistung eine Gruppe von SiteMapNode-Objekten hinzu.Adds a set of SiteMapNode objects to the collection.

Overloads

AddRange(SiteMapNode[])

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

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[])

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

public:
 virtual void AddRange(cli::array <System::Web::SiteMapNode ^> ^ value);
public virtual void AddRange (System.Web.SiteMapNode[] value);
abstract member AddRange : System.Web.SiteMapNode[] -> unit
override this.AddRange : System.Web.SiteMapNode[] -> unit
Public Overridable Sub AddRange (value As SiteMapNode())

Parameters

value
SiteMapNode[]

Ein Array vom Typ SiteMapNode, das der aktuellen SiteMapNodeCollection hinzugefügt werden soll.An array of type SiteMapNode to add to the current SiteMapNodeCollection.

Exceptions

value ist nullvalue is null.

SiteMapNodeCollection ist schreibgeschützt.The SiteMapNodeCollection is read-only.

Remarks

Das Array, das an die AddRange-Methode übermittelt wird, kann null Werte enthalten. Dies führt jedoch zu unerwarteten Ausnahmen, wenn die SiteMapNodeCollection Auflistung manipuliert wird.The array that is passed to the AddRange method can contain null values; however, this leads to unexpected exceptions when the SiteMapNodeCollection collection is manipulated.

Ein SiteMapNode-Objekt kann nicht zu einer SiteMapNodeCollectionmit Lese-oder fester Größe hinzugefügt werden.You cannot add a SiteMapNode object to a read-only or fixed-size SiteMapNodeCollection. Sie können testen, ob ein SiteMapNodeCollection schreibgeschützt ist, indem Sie die IsReadOnly-Eigenschaft überprüfen.You can test whether a SiteMapNodeCollection is read-only by checking the IsReadOnly property.

See also

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.

public:
 virtual void AddRange(System::Web::SiteMapNodeCollection ^ value);
public virtual void AddRange (System.Web.SiteMapNodeCollection value);
abstract member AddRange : System.Web.SiteMapNodeCollection -> unit
override this.AddRange : System.Web.SiteMapNodeCollection -> unit
Public Overridable Sub AddRange (value As SiteMapNodeCollection)

Parameters

value
SiteMapNodeCollection

Eine SiteMapNodeCollection, die die SiteMapNode-Objekte enthält, die der aktuellen SiteMapNodeCollection hinzugefügt werden sollen.A SiteMapNodeCollection that contains the SiteMapNode objects to add to the current SiteMapNodeCollection.

Exceptions

value ist nullvalue is null.

SiteMapNodeCollection ist schreibgeschützt.The SiteMapNodeCollection is read-only.

Examples

Im folgenden Codebeispiel wird veranschaulicht, wie eine änderbare SiteMapNodeCollection Auflistung erstellt und anschließend mithilfe der AddRange-Methode SiteMapNode-Objekte hinzugefügt werden.The following code example demonstrates how to create a modifiable SiteMapNodeCollection collection, and then add SiteMapNode objects to it using the AddRange method.


// 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

Remarks

Die SiteMapNodeCollection-Auflistung, die an die AddRange-Methode übermittelt wird, kann nullSiteMapNode Objekte enthalten. Dies führt jedoch zu unerwarteten Ausnahmen, wenn die SiteMapNodeCollection manipuliert wird.The SiteMapNodeCollection collection that is passed to the AddRange method can contain nullSiteMapNode objects; however, this leads to unexpected exceptions when the SiteMapNodeCollection is manipulated.

Ein SiteMapNode-Objekt kann nicht zu einer SiteMapNodeCollectionmit Lese-oder fester Größe hinzugefügt werden.You cannot add a SiteMapNode object to a read-only or fixed-size SiteMapNodeCollection. Sie können testen, ob ein SiteMapNodeCollection schreibgeschützt ist, indem Sie die IsReadOnly-Eigenschaft überprüfen.You can test whether a SiteMapNodeCollection is read-only by checking the IsReadOnly property.

See also

Applies to