SiteMapNodeCollection Classe

Definição

Fornece uma coleção fortemente tipada para objetos SiteMapNode e implementa a interface IHierarchicalEnumerable para dar suporte à navegação por meio da coleção.Provides a strongly typed collection for SiteMapNode objects and implements the IHierarchicalEnumerable interface to support navigating through the collection.

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 IEnumerable
    interface IList
    interface ICollection
Public Class SiteMapNodeCollection
Implements IHierarchicalEnumerable, IList
Herança
SiteMapNodeCollection
Implementações

Exemplos

O exemplo de código a seguir demonstra como criar SiteMapNodeCollection uma coleção e, em SiteMapNode seguida, adicionar objetos a AddRange ela usando o método.The following code example demonstrates how to create a SiteMapNodeCollection collection, and then add SiteMapNode objects to it using the AddRange method. O SiteMapNodeCollection é um subconjunto do mapa do site atual, mostrando apenas os dois primeiros níveis hierárquicos.The SiteMapNodeCollection is a subset of the current site map, showing only the first two hierarchical levels.


// 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 SiteMapNode para objetos.The SiteMapNodeCollection class provides a strongly typed collection for SiteMapNode objects. Ele armazena SiteMapNode objetos internamente em uma matriz baseada em zero.It stores SiteMapNode objects internally in a zero-based array.

Você pode modificar uma SiteMapNodeCollection coleção quando ela é criada pela primeira vez e, em seguida, usar os seguintes métodos para adicionar, SiteMapNode copiar e remover objetos:You can modify a SiteMapNodeCollection collection when it is first created, and then use the following methods to add, copy, and remove SiteMapNode objects:

Você pode criar um somente SiteMapNodeCollectionleitura, que não permite adicionar, copiar nem remover SiteMapNode objetos, usando o método estático ReadOnly .You can create a read-only SiteMapNodeCollection, which does not permit adding, copying, nor removing SiteMapNode objects, by using the static ReadOnly method. As SiteMapNodeCollection coleções que são retornadas SiteMapNode.GetAllNodes pelos métodos GetChildren e são somente leitura, como é o SiteMapNodeCollection que é retornado quando a ChildNodes propriedade é acessada em SiteMapNode um objeto que é retornado de um operador.The SiteMapNodeCollection collections that are returned by the SiteMapNode.GetAllNodes and GetChildren methods are read-only, as is the SiteMapNodeCollection that is returned when the ChildNodes property is accessed on a SiteMapNode object that is returned from a provider. Uma NotSupportedException exceção é lançada se você tentar modificar um somente SiteMapNodeCollection leitura definindo a propriedade do indexador padrão ou usando qualquer um dos seguintes métodos:A NotSupportedException exception is thrown, if you attempt to modify a read-only SiteMapNodeCollection by setting the default indexer property or by using any of the following methods:

Use a IsReadOnly propriedade para verificar a coleção antes de chamar qualquer um dos métodos na lista anterior.Use the IsReadOnly property to check the collection before calling any of the methods in the preceding list.

Construtores

SiteMapNodeCollection()

Inicializa uma nova instância da classe SiteMapNodeCollection, que é a instância padrão.Initializes a new instance of the SiteMapNodeCollection class, which is the default instance.

SiteMapNodeCollection(Int32)

Inicializa uma nova instância da classe SiteMapNodeCollection com a capacidade inicial especificada.Initializes a new instance of the SiteMapNodeCollection class with the specified initial capacity.

SiteMapNodeCollection(SiteMapNode)

Inicializa uma nova instância da classe SiteMapNodeCollection e adiciona o objeto SiteMapNode à propriedade InnerList para a coleção.Initializes a new instance of the SiteMapNodeCollection class and adds the SiteMapNode object to the InnerList property for the collection.

SiteMapNodeCollection(SiteMapNode[])

Inicializa uma nova instância da classe SiteMapNodeCollection e adiciona a matriz de tipo SiteMapNode à propriedade InnerList para a coleção.Initializes a new instance of the SiteMapNodeCollection class and adds the array of type SiteMapNode to the InnerList property for the collection.

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.Initializes a new instance of the SiteMapNodeCollection class and adds all the list items of the specified SiteMapNodeCollection collection to the InnerList property for the collection.

Propriedades

Count

Obtém o número de elementos contidos na coleção.Gets the number of elements contained in the collection.

IsFixedSize

Obtém um valor booliano que indica se os nós podem ser adicionados à coleção ou subtraídos dela.Gets a Boolean value indicating whether nodes can be added to or subtracted from the collection.

IsReadOnly

Obtém um valor booliano que indica se a coleção é somente leitura.Gets a Boolean value indicating whether the collection is read-only.

IsSynchronized

Obtém um valor booliano que indica se o acesso à coleção é sincronizado (thread-safe).Gets a Boolean value indicating whether access to the collection is synchronized (thread safe).

Item[Int32]

Obtém ou define o objeto SiteMapNode no índice especificado na coleção.Gets or sets the SiteMapNode object at the specified index in the collection.

SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso à coleção.Gets an object that can be used to synchronize access to the collection.

Métodos

Add(SiteMapNode)

Adiciona um único objeto SiteMapNode à coleção.Adds a single SiteMapNode object to the collection.

AddRange(SiteMapNode[])

Adiciona uma matriz de tipo SiteMapNode à coleção.Adds an array of type SiteMapNode to the collection.

AddRange(SiteMapNodeCollection)

Adiciona os nós no SiteMapNodeCollection especificado à coleção atual.Adds the nodes in the specified SiteMapNodeCollection to the current collection.

Clear()

Remove todos os itens da coleção.Removes all items from the collection.

Contains(SiteMapNode)

Determina se a coleção contém um objeto SiteMapNode específico.Determines whether the collection contains a specific SiteMapNode object.

CopyTo(SiteMapNode[], Int32)

Copia toda a coleção para uma matriz unidimensional compatível, começando no índice especificado da matriz de destino.Copies the entire collection to a compatible one-dimensional array, starting at the specified index of the target array.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetDataSourceView(SiteMapDataSource, String)

Recupera o objeto SiteMapDataSourceView associado aos nós na coleção atual.Retrieves the SiteMapDataSourceView object that is associated with the nodes in the current collection.

GetEnumerator()

Recupera uma referência a um objeto enumerador, usado para iterar sobre a coleção.Retrieves a reference to an enumerator object, which is used to iterate over the collection.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetHierarchicalDataSourceView()

Recupera o objeto SiteMapHierarchicalDataSourceView associado aos nós na coleção atual.Retrieves the SiteMapHierarchicalDataSourceView object that is associated with the nodes in the current collection.

GetHierarchyData(Object)

Retorna um item de dados hierárquicos para o item enumerado especificado.Returns a hierarchical data item for the specified enumerated item.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(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.Searches for the specified SiteMapNode object, and then returns the zero-based index of the first occurrence within the entire collection.

Insert(Int32, SiteMapNode)

Insere o objeto SiteMapNode especificado na coleção no índice especificado.Inserts the specified SiteMapNode object into the collection at the specified index.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
OnValidate(Object)

Executa processos personalizados adicionais ao validar um valor.Performs additional custom processes when validating a value.

ReadOnly(SiteMapNodeCollection)

Retorna uma coleção somente leitura que contém os nós na coleção SiteMapNodeCollection especificada.Returns a read-only collection that contains the nodes in the specified SiteMapNodeCollection collection.

Remove(SiteMapNode)

Remove o objeto SiteMapNode especificado da coleção.Removes the specified SiteMapNode object from the collection.

RemoveAt(Int32)

Remove o objeto SiteMapNode no índice especificado da coleção.Removes the SiteMapNode object at the specified index of the collection.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(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.Copies the elements of the ICollection interface to an array, starting at a particular array index. Essa classe não pode ser herdada.This class cannot be inherited.

ICollection.Count

Obtém o número de elementos contidos na interface ICollection.Gets the number of elements that are contained in the ICollection interface. Essa classe não pode ser herdada.This class cannot be inherited.

ICollection.IsSynchronized

Obtém um valor Boolean que indica se o acesso à interface ICollection é sincronizado (thread-safe).Gets a Boolean value indicating whether access to the ICollection interface is synchronized (thread safe). Essa classe não pode ser herdada.This class cannot be inherited.

ICollection.SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso à interface ICollection.Gets an object that can be used to synchronize access to the ICollection interface. Essa classe não pode ser herdada.This class cannot be inherited.

IEnumerable.GetEnumerator()

Retorna um enumerador que itera em uma coleção.Returns an enumerator that iterates through a collection. Para obter uma descrição desse membro, consulte GetEnumerator().For a description of this member, see GetEnumerator().

IHierarchicalEnumerable.GetHierarchyData(Object)

Retorna um item de dados hierárquicos para o item enumerado especificado.Returns a hierarchical data item for the specified enumerated item. Para obter uma descrição desse membro, consulte GetHierarchyData(Object).For a description of this member, see GetHierarchyData(Object).

IList.Add(Object)

Adiciona um item à coleção na interface IList.Adds an item to the collection in the IList interface. Para obter uma descrição desse membro, consulte Add(Object).For a description of this member, see Add(Object).

IList.Clear()

Remove todos os itens da coleção na interface IList.Removes all items from the collection in the IList interface. Para obter uma descrição desse membro, consulte Clear().For a description of this member, see Clear().

IList.Contains(Object)

Determina se a coleção na interface IList contém o valor booliano especificado.Determines whether the collection in the IList interface contains the specified Boolean value.

IList.IndexOf(Object)

Determina o índice do item específico na coleção retornada pela interface IList.Determines the index of the specific item in the collection that is returned by the IList interface. Para obter uma descrição desse membro, consulte IndexOf(Object).For a description of this member, see IndexOf(Object).

IList.Insert(Int32, Object)

Insere um item na coleção na interface IList no índice especificado.Inserts an item into the collection in the IList interface at the specified index. Para obter uma descrição desse membro, consulte Insert(Int32, Object).For a description of this member, see Insert(Int32, Object).

IList.IsFixedSize

Obtém um valor Boolean que indica se a coleção tem um tamanho fixo.Gets a Boolean value indicating whether the collection has a fixed size. Para obter uma descrição desse membro, consulte IsFixedSize.For a description of this member, see IsFixedSize.

IList.IsReadOnly

Obtém um valor Boolean que indica se a coleção é somente leitura.Gets a Boolean value indicating whether the collection is read-only. Para obter uma descrição desse membro, consulte IsReadOnly.For a description of this member, see IsReadOnly.

IList.Item[Int32]

Obtém o elemento IList no índice especificado.Gets the IList element at the specified index.

IList.Remove(Object)

Remove a primeira ocorrência de um objeto especificado da coleção na interface IList.Removes the first occurrence of a specified object from the collection in the IList interface. Para obter uma descrição desse membro, consulte Remove(Object).For a description of this member, see Remove(Object).

IList.RemoveAt(Int32)

Remove o item IList no índice especificado.Removes the IList item at the specified index. Para obter uma descrição desse membro, consulte RemoveAt(Int32).For a description of this member, see RemoveAt(Int32).

Métodos de Extensão

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a

Veja também