SiteMapNodeCollection.AddRange Método

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

Adiciona um conjunto de objetos SiteMapNode à coleção.

Sobrecargas

AddRange(SiteMapNode[])	Adiciona uma matriz de tipo SiteMapNode à coleção.
AddRange(SiteMapNodeCollection)	Adiciona os nós no SiteMapNodeCollection especificado à coleção atual.

AddRange(SiteMapNode[])

Adiciona uma matriz de tipo SiteMapNode à coleção.

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())

Parâmetros

value

SiteMapNode[]

Uma matriz do tipo SiteMapNode a ser adicionada ao SiteMapNodeCollectionatual.

Exceções

ArgumentException

value é null.

NotSupportedException

O SiteMapNodeCollection é somente leitura.

Comentários

A matriz passada para o método AddRange pode conter null valores; no entanto, isso leva a exceções inesperadas quando a coleção SiteMapNodeCollection é manipulada.

Não é possível adicionar um objeto SiteMapNode a um SiteMapNodeCollectionde tamanho fixo ou somente leitura. Você pode testar se um SiteMapNodeCollection é somente leitura verificando a propriedade IsReadOnly.

Confira também

• Add(SiteMapNode)
• Insert(Int32, SiteMapNode)
• Remove(SiteMapNode)

AddRange(SiteMapNodeCollection)

Adiciona os nós no SiteMapNodeCollection especificado à coleção atual.

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)

Parâmetros

value

SiteMapNodeCollection

Um SiteMapNodeCollection que contém os objetos SiteMapNode a serem adicionados ao SiteMapNodeCollectionatual.

Exceções

ArgumentException

value é null.

NotSupportedException

O SiteMapNodeCollection é somente leitura.

Exemplos

O exemplo de código a seguir demonstra como criar uma coleção de SiteMapNodeCollection modificável e, em seguida, adicionar objetos SiteMapNode a ela usando o método AddRange.

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

Comentários

A coleção SiteMapNodeCollection que é passada para o método AddRange pode conter objetos nullSiteMapNode; no entanto, isso leva a exceções inesperadas quando o SiteMapNodeCollection é manipulado.

Não é possível adicionar um objeto SiteMapNode a um SiteMapNodeCollectionde tamanho fixo ou somente leitura. Você pode testar se um SiteMapNodeCollection é somente leitura verificando a propriedade IsReadOnly.

Confira também

• Add(SiteMapNode)
• Insert(Int32, SiteMapNode)
• Remove(SiteMapNode)