SiteMapNodeCollection Classe

Definição

Fornece uma coleção fortemente tipada para SiteMapNode objetos e implementa a IHierarchicalEnumerable interface para suportar a navegação pela 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
SiteMapNodeCollection
Implementações

Exemplos

O exemplo de código seguinte demonstra como criar uma SiteMapNodeCollection coleção e depois adicionar SiteMapNode objetos a ela usando o AddRange método. É SiteMapNodeCollection um subconjunto do mapa atual do site, 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

Observações

A SiteMapNodeCollection classe fornece uma coleção fortemente tipada para SiteMapNode objetos. Armazena SiteMapNode objetos internamente num array baseado em zero.

Pode modificar uma SiteMapNodeCollection coleção quando for criada pela primeira vez e depois usar os seguintes métodos para adicionar, copiar e remover SiteMapNode objetos:

Pode criar um sistema somente SiteMapNodeCollectionde leitura, que não permite adicionar, copiar ou remover SiteMapNode objetos, usando o método estático ReadOnly . As SiteMapNodeCollection coleções que são devolvidas pelos SiteMapNode.GetAllNodes métodos e GetChildren são apenas de leitura, assim como o SiteMapNodeCollection que é devolvido quando a ChildNodes propriedade é acedida num SiteMapNode objeto devolvido por um fornecedor. Uma NotSupportedException exceção é lançada se tentar modificar um sistema de leitura somente SiteMapNodeCollection definindo a propriedade padrão do indexador 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 da lista anterior.

Construtores

Name Description
SiteMapNodeCollection()

Inicializa uma nova instância da SiteMapNodeCollection classe, que é a instância padrão.

SiteMapNodeCollection(Int32)

Inicializa uma nova instância da SiteMapNodeCollection classe com a capacidade inicial especificada.

SiteMapNodeCollection(SiteMapNode)

Inicializa uma nova instância da SiteMapNodeCollection classe e adiciona o SiteMapNode objeto à InnerList propriedade da coleção.

SiteMapNodeCollection(SiteMapNode[])

Inicializa uma nova instância da SiteMapNodeCollection classe e adiciona o array de tipo SiteMapNode à InnerList propriedade da coleção.

SiteMapNodeCollection(SiteMapNodeCollection)

Inicializa uma nova instância da SiteMapNodeCollection classe e adiciona todos os itens da lista da coleção especificada SiteMapNodeCollection à InnerList propriedade da coleção.

Propriedades

Name Description
Count

Obtém o número de elementos contidos na coleção.

IsFixedSize

Obtém um valor booleano que indica se os nós podem ser adicionados ou subtraídos da coleção.

IsReadOnly

Recebe um valor booleano que indica se a coleção é apenas leitura.

IsSynchronized

Recebe um valor Booleano que indica se o acesso à coleção está sincronizado (seguro para threads).

Item[Int32]

Obtém ou define o SiteMapNode objeto no índice especificado na coleção.

SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso à coleção.

Métodos

Name Description
Add(SiteMapNode)

Adiciona um único SiteMapNode objeto à SiteMapNodeCollection coleção.

AddRange(SiteMapNode[])

Adiciona um array de tipos SiteMapNode à coleção.

AddRange(SiteMapNodeCollection)

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

Clear()

Remove todos os itens da coleção.

Contains(SiteMapNode)

Determina se a coleção contém um objeto específico SiteMapNode .

CopyTo(SiteMapNode[], Int32)

Copia toda a coleção para um array unidimensional compatível, começando no índice especificado do array-alvo.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetDataSourceView(SiteMapDataSource, String)

Recupera o SiteMapDataSourceView objeto associado aos nós na coleção atual.

GetEnumerator()

Recupera uma referência a um objeto enumerador, que é usado para iterar sobre a coleção.

GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetHierarchicalDataSourceView()

Recupera o SiteMapHierarchicalDataSourceView objeto associado aos nós na coleção atual.

GetHierarchyData(Object)

Devolve um item de dados hierárquico para o item enumerado especificado.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IndexOf(SiteMapNode)

Procura o objeto especificado SiteMapNode e depois devolve o índice baseado em zero da primeira ocorrência dentro de toda a coleção.

Insert(Int32, SiteMapNode)

Insere o objeto especificado SiteMapNode na coleção no índice especificado.

MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
OnValidate(Object)

Realiza processos personalizados adicionais ao validar um valor.

ReadOnly(SiteMapNodeCollection)

Devolve uma coleção de apenas leitura que contém os nós da coleção especificada SiteMapNodeCollection .

Remove(SiteMapNode)

Remove o objeto especificado SiteMapNode da coleção.

RemoveAt(Int32)

Remove o SiteMapNode objeto no índice especificado da SiteMapNodeCollection coleção.

ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Implementações de Interface Explícita

Name Description
ICollection.CopyTo(Array, Int32)

Copia os elementos da ICollection interface para um array, começando num índice particular do array. Esta classe não pode ser herdada.

ICollection.Count

Obtém o número de elementos contidos na ICollection interface. Esta classe não pode ser herdada.

ICollection.IsSynchronized

Recebe um Boolean valor que indica se o acesso à ICollection interface está sincronizado (thread safe). Esta classe não pode ser herdada.

ICollection.SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso à ICollection interface. Esta classe não pode ser herdada.

IEnumerable.GetEnumerator()

Devolve um enumerador que itera numa coleção. Para uma descrição deste elemento, veja GetEnumerator().

IHierarchicalEnumerable.GetHierarchyData(Object)

Devolve um item de dados hierárquico para o item enumerado especificado. Para uma descrição deste elemento, veja GetHierarchyData(Object).

IList.Add(Object)

Adiciona um item à coleção na IList interface. Para uma descrição deste elemento, veja Add(Object).

IList.Clear()

Remove todos os itens da coleção na IList interface. Para uma descrição deste elemento, veja Clear().

IList.Contains(Object)

Determina se a coleção na IList interface contém o valor booleano especificado.

IList.IndexOf(Object)

Determina o índice do item específico na coleção que é devolvido pela IList interface. Para uma descrição deste elemento, veja IndexOf(Object).

IList.Insert(Int32, Object)

Insere um item na coleção na IList interface no índice especificado. Para uma descrição deste elemento, veja Insert(Int32, Object).

IList.IsFixedSize

Recebe um Boolean valor que indica se a coleção tem um tamanho fixo. Para uma descrição deste elemento, veja IsFixedSize.

IList.IsReadOnly

Recebe um Boolean valor que indica se a coleção é apenas de leitura. Para uma descrição deste elemento, veja IsReadOnly.

IList.Item[Int32]

Obtém o IList elemento no índice especificado.

IList.Remove(Object)

Remove a primeira ocorrência de um objeto especificado da coleção na IList interface. Para uma descrição deste elemento, veja Remove(Object).

IList.RemoveAt(Int32)

Remove o IList item no índice especificado. Para uma descrição deste elemento, veja RemoveAt(Int32).

Métodos da Extensão

Name Description
AsParallel(IEnumerable)

Permite a paralelização de uma consulta.

AsQueryable(IEnumerable)

Converte um IEnumerable para um IQueryable.

Cast<TResult>(IEnumerable)

Conjura os elementos de an IEnumerable para o tipo especificado.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base num tipo especificado.

Aplica-se a

Ver também