SiteMapNodeCollection Classe

Referência

Definição

Namespace:: System.Web

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece uma coleção fortemente tipada para objetos SiteMapNode e implementa a interface IHierarchicalEnumerable para dar suporte à navegação por meio da coleção.

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

Herança: Object
SiteMapNodeCollection

Implementações: ICollection IEnumerable IList IHierarchicalEnumerable

Exemplos

O exemplo de código a seguir demonstra como criar uma SiteMapNodeCollection coleção e, em seguida, adicionar SiteMapNode objetos a ela usando o AddRange método. É SiteMapNodeCollection um subconjunto do mapa do site atual, mostrando apenas os dois primeiros níveis hierárquicos.


// 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 SiteMapNodeCollection classe fornece uma coleção fortemente tipada para SiteMapNode objetos. Ele armazena SiteMapNode objetos internamente em uma matriz baseada em zero.

Você pode modificar uma SiteMapNodeCollection coleção quando ela for criada pela primeira vez e, em seguida, usar os seguintes métodos para adicionar, copiar e remover SiteMapNode objetos:

Para adicionar SiteMapNode objetos, use o e AddRange Insert os Addmétodos.
Para copiar SiteMapNode objetos, use o CopyTo método.
Para remover SiteMapNode objetos, use o Remove método.

Você pode criar um somente SiteMapNodeCollectionleitura, que não permite adicionar, copiar nem remover SiteMapNode objetos usando o método estático ReadOnly . As SiteMapNodeCollection coleções que são retornadas pelos SiteMapNode.GetAllNodes métodos e GetChildren são somente leitura, assim como as SiteMapNodeCollection que são retornadas quando a ChildNodes propriedade é acessada em um SiteMapNode objeto retornado de um provedor. Uma NotSupportedException exceção será gerada, se você tentar modificar um somente SiteMapNodeCollection leitura definindo a propriedade do indexador padrão ou usando qualquer um dos seguintes métodos:

Use a IsReadOnly propriedade para verificar a coleção antes de chamar qualquer um dos métodos na lista anterior.

Construtores

SiteMapNodeCollection()	Inicializa uma nova instância da classe SiteMapNodeCollection, que é a instância padrão.
SiteMapNodeCollection(Int32)	Inicializa uma nova instância da classe SiteMapNodeCollection com a capacidade inicial especificada.
SiteMapNodeCollection(SiteMapNode)	Inicializa uma nova instância da classe SiteMapNodeCollection e adiciona o objeto SiteMapNode à propriedade InnerList para a coleção.
SiteMapNodeCollection(SiteMapNode[])	Inicializa uma nova instância da classe SiteMapNodeCollection e adiciona a matriz de tipo SiteMapNode à propriedade InnerList para a coleção.
SiteMapNodeCollection(SiteMapNodeCollection)	Inicializa uma nova instância da classe SiteMapNodeCollection e adiciona todos os itens de lista da coleção SiteMapNodeCollection especificada à propriedade InnerList para a coleção.

Propriedades

Count	Obtém o número de elementos contidos na coleção.
IsFixedSize	Obtém um valor booliano que indica se os nós podem ser adicionados à coleção ou subtraídos dela.
IsReadOnly	Obtém um valor booliano que indica se a coleção é somente leitura.
IsSynchronized	Obtém um valor booliano que indica se o acesso à coleção é sincronizado (thread-safe).
Item[Int32]	Obtém ou define o objeto SiteMapNode no índice especificado na coleção.
SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso à coleção.

Métodos

Add(SiteMapNode)	Adiciona um único SiteMapNode objeto à SiteMapNodeCollection coleção.
AddRange(SiteMapNode[])	Adiciona uma matriz de tipo SiteMapNode à coleção.
AddRange(SiteMapNodeCollection)	Adiciona os nós no SiteMapNodeCollection especificado à coleção atual.
Clear()	Remove todos os itens da coleção.
Contains(SiteMapNode)	Determina se a coleção contém um objeto SiteMapNode específico.
CopyTo(SiteMapNode[], Int32)	Copia toda a coleção em uma matriz unidimensional compatível a partir do índice especificado da matriz de destino.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetDataSourceView(SiteMapDataSource, String)	Recupera o objeto SiteMapDataSourceView associado aos nós na coleção atual.
GetEnumerator()	Recupera uma referência a um objeto enumerador, usado para iterar sobre a coleção.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetHierarchicalDataSourceView()	Recupera o objeto SiteMapHierarchicalDataSourceView associado aos nós na coleção atual.
GetHierarchyData(Object)	Retorna um item de dados hierárquicos para o item enumerado especificado.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(SiteMapNode)	Pesquisa o objeto SiteMapNode especificado e, em seguida, retorna o índice de base zero da primeira ocorrência dentro de toda a coleção.
Insert(Int32, SiteMapNode)	Insere o objeto SiteMapNode especificado na coleção no índice especificado.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnValidate(Object)	Executa processos personalizados adicionais ao validar um valor.
ReadOnly(SiteMapNodeCollection)	Retorna uma coleção somente leitura que contém os nós na coleção SiteMapNodeCollection especificada.
Remove(SiteMapNode)	Remove o objeto SiteMapNode especificado da coleção.
RemoveAt(Int32)	Remove o SiteMapNode objeto no índice especificado da SiteMapNodeCollection coleção.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)	Copia os elementos da interface ICollection para uma matriz, começando em um índice de matriz específico. Essa classe não pode ser herdada.
ICollection.Count	Obtém o número de elementos contidos na interface ICollection. Essa classe não pode ser herdada.
ICollection.IsSynchronized	Obtém um valor `Boolean` que indica se o acesso à interface ICollection é sincronizado (thread-safe). Essa classe não pode ser herdada.
ICollection.SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso à interface ICollection. Essa classe não pode ser herdada.
IEnumerable.GetEnumerator()	Retorna um enumerador que itera em uma coleção. Para obter uma descrição desse membro, confira GetEnumerator().
IHierarchicalEnumerable.GetHierarchyData(Object)	Retorna um item de dados hierárquicos para o item enumerado especificado. Para obter uma descrição desse membro, confira GetHierarchyData(Object).
IList.Add(Object)	Adiciona um item à coleção na interface IList. Para obter uma descrição desse membro, confira Add(Object).
IList.Clear()	Remove todos os itens da coleção na interface IList. Para obter uma descrição desse membro, confira Clear().
IList.Contains(Object)	Determina se a coleção na interface IList contém o valor booliano especificado.
IList.IndexOf(Object)	Determina o índice do item específico na coleção retornada pela interface IList. Para obter uma descrição desse membro, confira IndexOf(Object).
IList.Insert(Int32, Object)	Insere um item na coleção na interface IList no índice especificado. Para obter uma descrição desse membro, confira Insert(Int32, Object).
IList.IsFixedSize	Obtém um valor `Boolean` que indica se a coleção tem um tamanho fixo. Para obter uma descrição desse membro, confira IsFixedSize.
IList.IsReadOnly	Obtém um valor `Boolean` que indica se a coleção é somente leitura. Para obter uma descrição desse membro, confira IsReadOnly.
IList.Item[Int32]	Obtém o elemento IList no índice especificado.
IList.Remove(Object)	Remove a primeira ocorrência de um objeto especificado da coleção na interface IList. Para obter uma descrição desse membro, confira Remove(Object).
IList.RemoveAt(Int32)	Remove o item IList no índice especificado. Para obter uma descrição desse membro, confira RemoveAt(Int32).

Métodos de Extensão

Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.

Aplica-se a