SiteMapNodeCollection Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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:
Para adicionar SiteMapNode objetos, use os Addmétodos , AddRange, e Insert .
Para copiar SiteMapNode objetos, use o CopyTo método.
Para remover SiteMapNode objetos, use o Remove método.
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 |
| 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 |
| IList.IsReadOnly |
Recebe um |
| 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. |