SiteMapNodeCollection.AddRange Method

Definition

Aggiunge un gruppo di oggetti SiteMapNode alla raccolta.Adds a set of SiteMapNode objects to the collection.

Overloads

AddRange(SiteMapNode[])

Aggiunge alla raccolta una matrice di tipo SiteMapNode.Adds an array of type SiteMapNode to the collection.

AddRange(SiteMapNodeCollection)

Aggiunge i nodi dell'elemento SiteMapNodeCollection specificato alla raccolta corrente.Adds the nodes in the specified SiteMapNodeCollection to the current collection.

AddRange(SiteMapNode[])

Aggiunge alla raccolta una matrice di tipo SiteMapNode.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[]

Matrice di tipo SiteMapNode da aggiungere all'elemento SiteMapNodeCollection corrente.An array of type SiteMapNode to add to the current SiteMapNodeCollection.

Exceptions

value è null.value is null.

La classe SiteMapNodeCollection è di sola lettura.The SiteMapNodeCollection is read-only.

Remarks

La matrice passata al metodo AddRange può contenere null valori; Tuttavia, questo genera eccezioni impreviste quando viene modificata la raccolta di SiteMapNodeCollection.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.

Non è possibile aggiungere un oggetto SiteMapNode a un SiteMapNodeCollectiondi sola lettura o di dimensioni fisse.You cannot add a SiteMapNode object to a read-only or fixed-size SiteMapNodeCollection. È possibile verificare se un SiteMapNodeCollection è di sola lettura controllando la proprietà IsReadOnly.You can test whether a SiteMapNodeCollection is read-only by checking the IsReadOnly property.

See also

AddRange(SiteMapNodeCollection)

Aggiunge i nodi dell'elemento SiteMapNodeCollection specificato alla raccolta corrente.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

Elemento SiteMapNodeCollection che contiene gli oggetti SiteMapNode da aggiungere all'elemento SiteMapNodeCollection corrente.A SiteMapNodeCollection that contains the SiteMapNode objects to add to the current SiteMapNodeCollection.

Exceptions

value è null.value is null.

La classe SiteMapNodeCollection è di sola lettura.The SiteMapNodeCollection is read-only.

Examples

Nell'esempio di codice seguente viene illustrato come creare una raccolta di SiteMapNodeCollection modificabile e quindi aggiungervi SiteMapNode oggetti usando il metodo AddRange.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

La raccolta di SiteMapNodeCollection passata al metodo AddRange può contenere nulloggetti SiteMapNode; Tuttavia, questo genera eccezioni impreviste quando il SiteMapNodeCollection viene modificato.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.

Non è possibile aggiungere un oggetto SiteMapNode a un SiteMapNodeCollectiondi sola lettura o di dimensioni fisse.You cannot add a SiteMapNode object to a read-only or fixed-size SiteMapNodeCollection. È possibile verificare se un SiteMapNodeCollection è di sola lettura controllando la proprietà IsReadOnly.You can test whether a SiteMapNodeCollection is read-only by checking the IsReadOnly property.

See also

Applies to