SiteMapNodeCollection SiteMapNodeCollection SiteMapNodeCollection SiteMapNodeCollection Class

Definizione

Specifica una raccolta fortemente tipizzata per oggetti SiteMapNode e implementa l'interfaccia IHierarchicalEnumerable per supportare lo spostamento nella raccolta.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
Ereditarietà
SiteMapNodeCollectionSiteMapNodeCollectionSiteMapNodeCollectionSiteMapNodeCollection
Implementazioni

Esempi

Esempio di codice seguente viene illustrato come creare un SiteMapNodeCollection insieme e quindi aggiungere SiteMapNode oggetti mediante il AddRange (metodo).The following code example demonstrates how to create a SiteMapNodeCollection collection, and then add SiteMapNode objects to it using the AddRange method. Il SiteMapNodeCollection è un subset della mappa del sito corrente, che mostra solo i primi due livelli gerarchici.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

Commenti

Il SiteMapNodeCollection classe fornisce una raccolta fortemente tipizzata per SiteMapNode oggetti.The SiteMapNodeCollection class provides a strongly typed collection for SiteMapNode objects. Archivia SiteMapNode oggetti internamente in una matrice in base zero.It stores SiteMapNode objects internally in a zero-based array.

È possibile modificare un SiteMapNodeCollection raccolta quando si è creato e quindi usare i metodi seguenti per aggiungere, copiare e rimuovere SiteMapNode oggetti:You can modify a SiteMapNodeCollection collection when it is first created, and then use the following methods to add, copy, and remove SiteMapNode objects:

È possibile creare una proprietà di sola lettura SiteMapNodeCollection, che non consente l'aggiunta, la copia o la rimozione SiteMapNode oggetti, tramite il metodo statico ReadOnly (metodo).You can create a read-only SiteMapNodeCollection, which does not permit adding, copying, nor removing SiteMapNode objects, by using the static ReadOnly method. Il SiteMapNodeCollection raccolte restituite dal SiteMapNode.GetAllNodes e GetChildren metodi sono di sola lettura, così come sono il SiteMapNodeCollection che viene restituito quando il ChildNodes in cui si accede alla proprietà un SiteMapNode oggetto restituito da un provider.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. Oggetto NotSupportedException viene generata l'eccezione, se si prova a modificare una proprietà di sola lettura SiteMapNodeCollection impostando la proprietà dell'indicizzatore predefinita o utilizzando uno dei metodi seguenti: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:

Usare il IsReadOnly proprietà per controllare la raccolta prima di chiamare uno dei metodi nell'elenco precedente.Use the IsReadOnly property to check the collection before calling any of the methods in the preceding list.

Costruttori

SiteMapNodeCollection() SiteMapNodeCollection() SiteMapNodeCollection() SiteMapNodeCollection()

Inizializza una nuova istanza della classe SiteMapNodeCollection, che è l'istanza predefinita.Initializes a new instance of the SiteMapNodeCollection class, which is the default instance.

SiteMapNodeCollection(Int32) SiteMapNodeCollection(Int32) SiteMapNodeCollection(Int32) SiteMapNodeCollection(Int32)

Inizializza una nuova istanza della classe SiteMapNodeCollection con la capacità iniziale specificata.Initializes a new instance of the SiteMapNodeCollection class with the specified initial capacity.

SiteMapNodeCollection(SiteMapNode) SiteMapNodeCollection(SiteMapNode) SiteMapNodeCollection(SiteMapNode) SiteMapNodeCollection(SiteMapNode)

Inizializza una nuova istanza della classe SiteMapNodeCollection e aggiunge l'oggetto SiteMapNode alla proprietà InnerList della raccolta.Initializes a new instance of the SiteMapNodeCollection class and adds the SiteMapNode object to the InnerList property for the collection.

SiteMapNodeCollection(SiteMapNodeCollection) SiteMapNodeCollection(SiteMapNodeCollection) SiteMapNodeCollection(SiteMapNodeCollection) SiteMapNodeCollection(SiteMapNodeCollection)

Inizializza una nuova istanza della classe SiteMapNodeCollection e aggiunge tutte le voci dell'elenco della raccolta SiteMapNodeCollection specificata alla proprietà InnerList della raccolta.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.

SiteMapNodeCollection(SiteMapNode[]) SiteMapNodeCollection(SiteMapNode[]) SiteMapNodeCollection(SiteMapNode[]) SiteMapNodeCollection(SiteMapNode[])

Inizializza una nuova istanza della classe SiteMapNodeCollection e aggiunge la matrice del tipo SiteMapNode alla proprietà InnerList della raccolta.Initializes a new instance of the SiteMapNodeCollection class and adds the array of type SiteMapNode to the InnerList property for the collection.

Proprietà

Count Count Count Count

Ottiene il numero di elementi contenuti nella raccolta.Gets the number of elements contained in the collection.

IsFixedSize IsFixedSize IsFixedSize IsFixedSize

Ottiene un valore booleano indicante se è possibile aggiungere o sottrarre nodi dalla raccolta.Gets a Boolean value indicating whether nodes can be added to or subtracted from the collection.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Ottiene un valore booleano che indica se la raccolta è di sola lettura.Gets a Boolean value indicating whether the collection is read-only.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Ottiene un valore booleano che indica se l'accesso alla raccolta è sincronizzato (thread-safe).Gets a Boolean value indicating whether access to the collection is synchronized (thread safe).

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ottiene o imposta l'oggetto SiteMapNode nella raccolta, in corrispondenza dell'indice specificato.Gets or sets the SiteMapNode object at the specified index in the collection.

SyncRoot SyncRoot SyncRoot SyncRoot

Ottiene un oggetto che può essere usato per sincronizzare l'accesso alla raccolta.Gets an object that can be used to synchronize access to the collection.

Metodi

Add(SiteMapNode) Add(SiteMapNode) Add(SiteMapNode) Add(SiteMapNode)

Aggiunge un singolo oggetto SiteMapNode alla raccolta.Adds a single SiteMapNode object to the collection.

AddRange(SiteMapNodeCollection) AddRange(SiteMapNodeCollection) AddRange(SiteMapNodeCollection) AddRange(SiteMapNodeCollection)

Aggiunge i nodi dell'elemento SiteMapNodeCollection specificato alla raccolta corrente.Adds the nodes in the specified SiteMapNodeCollection to the current collection.

AddRange(SiteMapNode[]) AddRange(SiteMapNode[]) AddRange(SiteMapNode[]) AddRange(SiteMapNode[])

Aggiunge alla raccolta una matrice di tipo SiteMapNode.Adds an array of type SiteMapNode to the collection.

Clear() Clear() Clear() Clear()

Rimuove tutti gli elementi dalla raccolta.Removes all items from the collection.

Contains(SiteMapNode) Contains(SiteMapNode) Contains(SiteMapNode) Contains(SiteMapNode)

Determina se la raccolta contiene un oggetto SiteMapNode specifico.Determines whether the collection contains a specific SiteMapNode object.

CopyTo(SiteMapNode[], Int32) CopyTo(SiteMapNode[], Int32) CopyTo(SiteMapNode[], Int32) CopyTo(SiteMapNode[], Int32)

Copia l'intera raccolta in una matrice unidimensionale compatibile, a partire dall'indice specificato della matrice di destinazione.Copies the entire collection to a compatible one-dimensional array, starting at the specified index of the target array.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetDataSourceView(SiteMapDataSource, String) GetDataSourceView(SiteMapDataSource, String) GetDataSourceView(SiteMapDataSource, String) GetDataSourceView(SiteMapDataSource, String)

Recupera l'oggetto SiteMapDataSourceView associato ai nodi della raccolta corrente.Retrieves the SiteMapDataSourceView object that is associated with the nodes in the current collection.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Recupera un riferimento a un oggetto enumeratore, che viene usato per scorrere la raccolta.Retrieves a reference to an enumerator object, which is used to iterate over the collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetHierarchicalDataSourceView() GetHierarchicalDataSourceView() GetHierarchicalDataSourceView() GetHierarchicalDataSourceView()

Recupera l'oggetto SiteMapHierarchicalDataSourceView associato ai nodi della raccolta corrente.Retrieves the SiteMapHierarchicalDataSourceView object that is associated with the nodes in the current collection.

GetHierarchyData(Object) GetHierarchyData(Object) GetHierarchyData(Object) GetHierarchyData(Object)

Restituisce un elemento di dati gerarchici per l'elemento enumerato specificato.Returns a hierarchical data item for the specified enumerated item.

GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(SiteMapNode) IndexOf(SiteMapNode) IndexOf(SiteMapNode) IndexOf(SiteMapNode)

Ricerca l'oggetto SiteMapNode specificato e restituisce l'indice in base zero della prima occorrenza nell'intera raccolta.Searches for the specified SiteMapNode object, and then returns the zero-based index of the first occurrence within the entire collection.

Insert(Int32, SiteMapNode) Insert(Int32, SiteMapNode) Insert(Int32, SiteMapNode) Insert(Int32, SiteMapNode)

Inserisce l'oggetto SiteMapNode specificato nella raccolta in corrispondenza dell'indice specificato.Inserts the specified SiteMapNode object into the collection at the specified index.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
OnValidate(Object) OnValidate(Object) OnValidate(Object) OnValidate(Object)

Esegue processi personalizzati aggiuntivi durante la convalida di un valore.Performs additional custom processes when validating a value.

ReadOnly(SiteMapNodeCollection) ReadOnly(SiteMapNodeCollection) ReadOnly(SiteMapNodeCollection) ReadOnly(SiteMapNodeCollection)

Restituisce una raccolta di sola lettura che contiene i nodi nella raccolta SiteMapNodeCollection specificata.Returns a read-only collection that contains the nodes in the specified SiteMapNodeCollection collection.

Remove(SiteMapNode) Remove(SiteMapNode) Remove(SiteMapNode) Remove(SiteMapNode)

Rimuove l'oggetto SiteMapNode specificato dalla raccolta.Removes the specified SiteMapNode object from the collection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Rimuove l'oggetto SiteMapNode in corrispondenza dell'indice specificato della raccolta.Removes the SiteMapNode object at the specified index of the collection.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)

Copia gli elementi dell'interfaccia ICollection in una matrice, a partire da un determinato indice di matrice.Copies the elements of the ICollection interface to an array, starting at a particular array index. Questa classe non può essere ereditata.This class cannot be inherited.

ICollection.Count ICollection.Count ICollection.Count ICollection.Count

Ottiene il numero degli elementi contenuti nell'interfaccia ICollection.Gets the number of elements that are contained in the ICollection interface. Questa classe non può essere ereditata.This class cannot be inherited.

ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

Ottiene un valore Boolean che indica se l'accesso all'interfaccia ICollection è sincronizzato (thread-safe).Gets a Boolean value indicating whether access to the ICollection interface is synchronized (thread safe). Questa classe non può essere ereditata.This class cannot be inherited.

ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

Ottiene un oggetto che può essere usato per sincronizzare l'accesso all'interfaccia ICollection.Gets an object that can be used to synchronize access to the ICollection interface. Questa classe non può essere ereditata.This class cannot be inherited.

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Restituisce un enumeratore che consente di eseguire l'iterazione di una raccolta.Returns an enumerator that iterates through a collection. Per una descrizione di questo membro, vedere GetEnumerator().For a description of this member, see GetEnumerator().

IHierarchicalEnumerable.GetHierarchyData(Object) IHierarchicalEnumerable.GetHierarchyData(Object) IHierarchicalEnumerable.GetHierarchyData(Object) IHierarchicalEnumerable.GetHierarchyData(Object)

Restituisce un elemento di dati gerarchici per l'elemento enumerato specificato.Returns a hierarchical data item for the specified enumerated item. Per una descrizione di questo membro, vedere GetHierarchyData(Object).For a description of this member, see GetHierarchyData(Object).

IList.Add(Object) IList.Add(Object) IList.Add(Object) IList.Add(Object)

Aggiunge un elemento alla raccolta nell'interfaccia IList.Adds an item to the collection in the IList interface. Per una descrizione di questo membro, vedere Add(Object).For a description of this member, see Add(Object).

IList.Clear() IList.Clear() IList.Clear() IList.Clear()

Rimuove tutti gli elementi dalla raccolta nell'interfaccia IList.Removes all items from the collection in the IList interface. Per una descrizione di questo membro, vedere Clear().For a description of this member, see Clear().

IList.Contains(Object) IList.Contains(Object) IList.Contains(Object) IList.Contains(Object)

Determina se la raccolta dell'interfaccia IList contiene il valore booleano specificato.Determines whether the collection in the IList interface contains the specified Boolean value.

IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object)

Determina l'indice dell'elemento specifico della raccolta che viene restituito dall'interfaccia IList.Determines the index of the specific item in the collection that is returned by the IList interface. Per una descrizione di questo membro, vedere IndexOf(Object).For a description of this member, see IndexOf(Object).

IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object)

Consente di inserire un elemento nella raccolta dell'interfaccia IList, in corrispondenza dell'indice specificato.Inserts an item into the collection in the IList interface at the specified index. Per una descrizione di questo membro, vedere Insert(Int32, Object).For a description of this member, see Insert(Int32, Object).

IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize

Ottiene un valore che indica se la dimensione della raccolta Boolean è fissa.Gets a Boolean value indicating whether the collection has a fixed size. Per una descrizione di questo membro, vedere IsFixedSize.For a description of this member, see IsFixedSize.

IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly

Ottiene un valore Boolean che indica se la raccolta è di sola lettura.Gets a Boolean value indicating whether the collection is read-only. Per una descrizione di questo membro, vedere IsReadOnly.For a description of this member, see IsReadOnly.

IList.Item[Int32] IList.Item[Int32] IList.Item[Int32] IList.Item[Int32]

Ottiene l'elemento IList in corrispondenza dell'indice specificato.Gets the IList element at the specified index.

IList.Remove(Object) IList.Remove(Object) IList.Remove(Object) IList.Remove(Object)

Rimuove la prima ricorrenza di un oggetto specificato dalla raccolta nell'interfaccia IList.Removes the first occurrence of a specified object from the collection in the IList interface. Per una descrizione di questo membro, vedere Remove(Object).For a description of this member, see Remove(Object).

IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32)

Rimuove l'elemento IList in corrispondenza dell'indice specificato.Removes the IList item at the specified index. Per una descrizione di questo membro, vedere RemoveAt(Int32).For a description of this member, see RemoveAt(Int32).

Extension Methods

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Consente la parallelizzazione di una query.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Converte un' IEnumerable a un IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a

Vedi anche