SiteMapNodeCollection Clase

Definición

Proporciona una colección fuertemente tipada de objetos SiteMapNode e implementa la interfaz IHierarchicalEnumerable para admitir la navegación a través de la colección.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 IList
    interface ICollection
    interface IEnumerable
type SiteMapNodeCollection = class
    interface IHierarchicalEnumerable
    interface IEnumerable
    interface IList
    interface ICollection
Public Class SiteMapNodeCollection
Implements IHierarchicalEnumerable, IList
Herencia
SiteMapNodeCollection
Implementaciones

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una SiteMapNodeCollection colección y, a continuación, cómo agregar SiteMapNode objetos a ella mediante el AddRange método.The following code example demonstrates how to create a SiteMapNodeCollection collection, and then add SiteMapNode objects to it using the AddRange method. SiteMapNodeCollectionEs un subconjunto del mapa del sitio actual, que muestra solo los dos primeros niveles jerá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

Comentarios

La SiteMapNodeCollection clase proporciona una colección fuertemente tipada para los SiteMapNode objetos.The SiteMapNodeCollection class provides a strongly typed collection for SiteMapNode objects. Almacena los SiteMapNode objetos internamente en una matriz de base cero.It stores SiteMapNode objects internally in a zero-based array.

Puede modificar una SiteMapNodeCollection colección cuando se crea por primera vez y, a continuación, usar los métodos siguientes para agregar, copiar y quitar SiteMapNode 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:

Puede crear un objeto de solo lectura SiteMapNodeCollection , que no permite agregar, copiar ni quitar SiteMapNode objetos, mediante el ReadOnly método estático.You can create a read-only SiteMapNodeCollection, which does not permit adding, copying, nor removing SiteMapNode objects, by using the static ReadOnly method. Las SiteMapNodeCollection colecciones devueltas por los SiteMapNode.GetAllNodes GetChildren métodos y son de solo lectura, como es el SiteMapNodeCollection que se devuelve cuando ChildNodes se tiene acceso a la propiedad en un SiteMapNode objeto que se devuelve desde un proveedor.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. NotSupportedExceptionSe produce una excepción, si intenta modificar un solo lectura estableciendo SiteMapNodeCollection la propiedad de indizador predeterminada o con cualquiera de los métodos siguientes: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:

Utilice la IsReadOnly propiedad para comprobar la colección antes de llamar a cualquiera de los métodos de la lista anterior.Use the IsReadOnly property to check the collection before calling any of the methods in the preceding list.

Constructores

SiteMapNodeCollection()

Inicializa una nueva instancia de la clase SiteMapNodeCollection, que es la predeterminada.Initializes a new instance of the SiteMapNodeCollection class, which is the default instance.

SiteMapNodeCollection(Int32)

Inicializa una nueva instancia de la clase SiteMapNodeCollection con la capacidad inicial especificada.Initializes a new instance of the SiteMapNodeCollection class with the specified initial capacity.

SiteMapNodeCollection(SiteMapNode)

Inicializa una nueva instancia de la clase SiteMapNodeCollection y agrega el objeto SiteMapNode a la propiedad InnerList de la colección.Initializes a new instance of the SiteMapNodeCollection class and adds the SiteMapNode object to the InnerList property for the collection.

SiteMapNodeCollection(SiteMapNode[])

Inicializa una nueva instancia de la clase SiteMapNodeCollection y agrega la matriz de tipo SiteMapNode a la propiedad InnerList de la colección.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 una nueva instancia de la clase SiteMapNodeCollection y agrega todos los elementos de lista de la colección SiteMapNodeCollection especificada a la propiedad InnerList de la colección.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.

Propiedades

Count

Obtiene el número de elementos incluidos en la colección.Gets the number of elements contained in the collection.

IsFixedSize

Obtiene un valor booleano que indica si los nodos se pueden agregar o restar a la colección.Gets a Boolean value indicating whether nodes can be added to or subtracted from the collection.

IsReadOnly

Obtiene un valor booleano que indica si la colección es de sólo lectura.Gets a Boolean value indicating whether the collection is read-only.

IsSynchronized

Obtiene un valor booleano que indica si el acceso a la colección está sincronizado (es seguro para la ejecución de subprocesos).Gets a Boolean value indicating whether access to the collection is synchronized (thread safe).

Item[Int32]

Obtiene o establece el objeto SiteMapNode en el índice especificado de la colección.Gets or sets the SiteMapNode object at the specified index in the collection.

SyncRoot

Obtiene un objeto que se puede usar para sincronizar el acceso a la colección.Gets an object that can be used to synchronize access to the collection.

Métodos

Add(SiteMapNode)

Agrega un solo objeto SiteMapNode a la colección.Adds a single SiteMapNode object to the collection.

AddRange(SiteMapNode[])

Agrega una matriz de tipo SiteMapNode a la colección.Adds an array of type SiteMapNode to the collection.

AddRange(SiteMapNodeCollection)

Agrega los nodos de la SiteMapNodeCollection especificada a la colección actual.Adds the nodes in the specified SiteMapNodeCollection to the current collection.

Clear()

Quita todos los elementos de la colección.Removes all items from the collection.

Contains(SiteMapNode)

Determina si la colección contiene un objeto SiteMapNode específico.Determines whether the collection contains a specific SiteMapNode object.

CopyTo(SiteMapNode[], Int32)

Copia la colección completa en una matriz unidimensional compatible, empezando en el índice especificado de la 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 si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetDataSourceView(SiteMapDataSource, String)

Recupera el objeto SiteMapDataSourceView asociado con los nodos de la colección actual.Retrieves the SiteMapDataSourceView object that is associated with the nodes in the current collection.

GetEnumerator()

Recupera una referencia a un objeto del enumerador, que se utiliza para recorrer en iteración la colección.Retrieves a reference to an enumerator object, which is used to iterate over the collection.

GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetHierarchicalDataSourceView()

Recupera el objeto SiteMapHierarchicalDataSourceView asociado con los nodos de la colección actual.Retrieves the SiteMapHierarchicalDataSourceView object that is associated with the nodes in the current collection.

GetHierarchyData(Object)

Devuelve un elemento de datos jerárquico para el elemento enumerado especificado.Returns a hierarchical data item for the specified enumerated item.

GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
IndexOf(SiteMapNode)

Busca el objeto SiteMapNode especificado y, a continuación, devuelve el índice de base cero de la primera aparición en la colección completa.Searches for the specified SiteMapNode object, and then returns the zero-based index of the first occurrence within the entire collection.

Insert(Int32, SiteMapNode)

Inserta el objeto SiteMapNode especificado en el índice especificado de la colección.Inserts the specified SiteMapNode object into the collection at the specified index.

MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
OnValidate(Object)

Realiza procesos de personalización adicionales al validar un valor.Performs additional custom processes when validating a value.

ReadOnly(SiteMapNodeCollection)

Devuelve una colección de sólo lectura que contiene los nodos de la colección SiteMapNodeCollection especificada.Returns a read-only collection that contains the nodes in the specified SiteMapNodeCollection collection.

Remove(SiteMapNode)

Quita el objeto SiteMapNode especificado de la colección.Removes the specified SiteMapNode object from the collection.

RemoveAt(Int32)

Quita de la colección el objeto SiteMapNode situado en el índice especificado.Removes the SiteMapNode object at the specified index of the collection.

ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Implementaciones de interfaz explícitas

ICollection.CopyTo(Array, Int32)

Copia los elementos de la interfaz ICollection en una matriz, que empieza en un índice determinado de la matriz.Copies the elements of the ICollection interface to an array, starting at a particular array index. Esta clase no puede heredarse.This class cannot be inherited.

ICollection.Count

Obtiene el número de elementos contenidos en la interfaz ICollection.Gets the number of elements that are contained in the ICollection interface. Esta clase no puede heredarse.This class cannot be inherited.

ICollection.IsSynchronized

Obtiene un valor Boolean que indica si el acceso a la interfaz ICollection está sincronizado (seguro para la ejecución de subprocesos).Gets a Boolean value indicating whether access to the ICollection interface is synchronized (thread safe). Esta clase no puede heredarse.This class cannot be inherited.

ICollection.SyncRoot

Obtiene un objeto que se puede utilizar para sincronizar el acceso a la interfaz ICollection.Gets an object that can be used to synchronize access to the ICollection interface. Esta clase no puede heredarse.This class cannot be inherited.

IEnumerable.GetEnumerator()

Devuelve un enumerador que recorre en iteración una colección.Returns an enumerator that iterates through a collection. Para obtener una descripción de este miembro, vea GetEnumerator().For a description of this member, see GetEnumerator().

IHierarchicalEnumerable.GetHierarchyData(Object)

Devuelve un elemento de datos jerárquico para el elemento enumerado especificado.Returns a hierarchical data item for the specified enumerated item. Para obtener una descripción de este miembro, vea GetHierarchyData(Object).For a description of this member, see GetHierarchyData(Object).

IList.Add(Object)

Agrega un elemento a la colección de la interfaz IList.Adds an item to the collection in the IList interface. Para obtener una descripción de este miembro, vea Add(Object).For a description of this member, see Add(Object).

IList.Clear()

Quita todos los elementos de la colección de la interfaz IList.Removes all items from the collection in the IList interface. Para obtener una descripción de este miembro, vea Clear().For a description of this member, see Clear().

IList.Contains(Object)

Determina si la colección de la interfaz IList contiene el valor booleano especificado.Determines whether the collection in the IList interface contains the specified Boolean value.

IList.IndexOf(Object)

Determina el índice del elemento concreto de la colección devuelto por la interfaz IList.Determines the index of the specific item in the collection that is returned by the IList interface. Para obtener una descripción de este miembro, vea IndexOf(Object).For a description of this member, see IndexOf(Object).

IList.Insert(Int32, Object)

Inserta un elemento en el índice especificado de la colección de la interfaz IList.Inserts an item into the collection in the IList interface at the specified index. Para obtener una descripción de este miembro, vea Insert(Int32, Object).For a description of this member, see Insert(Int32, Object).

IList.IsFixedSize

Obtiene un valor Boolean que indica si la colección tiene un tamaño fijo.Gets a Boolean value indicating whether the collection has a fixed size. Para obtener una descripción de este miembro, vea IsFixedSize.For a description of this member, see IsFixedSize.

IList.IsReadOnly

Obtiene un valor Boolean que indica si la colección es de sólo lectura.Gets a Boolean value indicating whether the collection is read-only. Para obtener una descripción de este miembro, vea IsReadOnly.For a description of this member, see IsReadOnly.

IList.Item[Int32]

Obtiene el elemento IList en el índice especificado.Gets the IList element at the specified index.

IList.Remove(Object)

Quita la primera aparición de un objeto concreto de la colección de la interfaz IList.Removes the first occurrence of a specified object from the collection in the IList interface. Para obtener una descripción de este miembro, vea Remove(Object).For a description of this member, see Remove(Object).

IList.RemoveAt(Int32)

Quita el elemento de la interfaz IList que se encuentra en el índice especificado.Removes the IList item at the specified index. Para obtener una descripción de este miembro, vea RemoveAt(Int32).For a description of this member, see RemoveAt(Int32).

Métodos de extensión

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a

Consulte también