SiteMapNodeCollection Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Specifica una raccolta fortemente tipizzata per oggetti SiteMapNode e implementa l'interfaccia IHierarchicalEnumerable per supportare lo spostamento nella raccolta.

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

Ereditarietà: Object
SiteMapNodeCollection

Implementazioni: ICollection IEnumerable IList IHierarchicalEnumerable

Esempio

Nell'esempio di codice seguente viene illustrato come creare una SiteMapNodeCollection raccolta e quindi aggiungere SiteMapNode oggetti al AddRange metodo. È SiteMapNodeCollection un subset della mappa del sito corrente, che mostra solo i primi due livelli gerarchici.


// 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

La SiteMapNodeCollection classe fornisce una raccolta fortemente tipizzata per SiteMapNode gli oggetti. Archivia SiteMapNode gli oggetti internamente in una matrice basata su zero.

È possibile modificare una SiteMapNodeCollection raccolta quando viene prima creata e quindi usare i metodi seguenti per aggiungere, copiare e rimuovere SiteMapNode oggetti:

Per aggiungere SiteMapNode oggetti, usare i Addmetodi , AddRangee Insert .
Per copiare SiteMapNode oggetti, usare il CopyTo metodo .
Per rimuovere SiteMapNode oggetti, usare il Remove metodo .

È possibile creare un oggetto di sola SiteMapNodeCollectionlettura che non consente di aggiungere, copiare o rimuovere SiteMapNode oggetti usando il metodo statico ReadOnly . Le SiteMapNodeCollection raccolte restituite dai SiteMapNode.GetAllNodes metodi e GetChildren sono di sola lettura, come SiteMapNodeCollection viene restituito quando la ChildNodes proprietà viene accessibile a un oggetto restituito da un SiteMapNode provider. Viene NotSupportedException generata un'eccezione, se si tenta di modificare una proprietà di sola SiteMapNodeCollection lettura impostando la proprietà indicizzatore predefinita o usando uno dei metodi seguenti:

Utilizzare la IsReadOnly proprietà per controllare la raccolta prima di chiamare uno dei metodi nell'elenco precedente.

Costruttori

SiteMapNodeCollection()	Inizializza una nuova istanza della classe SiteMapNodeCollection, che è l'istanza predefinita.
SiteMapNodeCollection(Int32)	Inizializza una nuova istanza della classe SiteMapNodeCollection con la capacità iniziale specificata.
SiteMapNodeCollection(SiteMapNode)	Inizializza una nuova istanza della classe SiteMapNodeCollection e aggiunge l'oggetto SiteMapNode alla proprietà InnerList della raccolta.
SiteMapNodeCollection(SiteMapNode[])	Inizializza una nuova istanza della classe SiteMapNodeCollection e aggiunge la matrice del tipo SiteMapNode alla proprietà InnerList della raccolta.
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.

Proprietà

Count	Ottiene il numero di elementi contenuti nella raccolta.
IsFixedSize	Ottiene un valore booleano indicante se è possibile aggiungere o sottrarre nodi dalla raccolta.
IsReadOnly	Ottiene un valore booleano che indica se la raccolta è di sola lettura.
IsSynchronized	Ottiene un valore booleano che indica se l'accesso alla raccolta è sincronizzato (thread-safe).
Item[Int32]	Ottiene o imposta l'oggetto SiteMapNode nella raccolta, in corrispondenza dell'indice specificato.
SyncRoot	Ottiene un oggetto che può essere usato per sincronizzare l'accesso alla raccolta.

Metodi

Add(SiteMapNode)	Aggiunge un singolo SiteMapNode oggetto all'insieme SiteMapNodeCollection .
AddRange(SiteMapNode[])	Aggiunge alla raccolta una matrice di tipo SiteMapNode.
AddRange(SiteMapNodeCollection)	Aggiunge i nodi dell'elemento SiteMapNodeCollection specificato alla raccolta corrente.
Clear()	Rimuove tutti gli elementi dalla raccolta.
Contains(SiteMapNode)	Determina se la raccolta contiene un oggetto SiteMapNode specifico.
CopyTo(SiteMapNode[], Int32)	Copia l'intera raccolta in una matrice unidimensionale compatibile, iniziando in corrispondenza dell'indice specificato della matrice di destinazione.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetDataSourceView(SiteMapDataSource, String)	Recupera l'oggetto SiteMapDataSourceView associato ai nodi della raccolta corrente.
GetEnumerator()	Recupera un riferimento a un oggetto enumeratore, che viene usato per scorrere la raccolta.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetHierarchicalDataSourceView()	Recupera l'oggetto SiteMapHierarchicalDataSourceView associato ai nodi della raccolta corrente.
GetHierarchyData(Object)	Restituisce un elemento di dati gerarchici per l'elemento enumerato specificato.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IndexOf(SiteMapNode)	Ricerca l'oggetto SiteMapNode specificato e restituisce l'indice in base zero della prima occorrenza nell'intera raccolta.
Insert(Int32, SiteMapNode)	Inserisce l'oggetto SiteMapNode specificato nella raccolta in corrispondenza dell'indice specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnValidate(Object)	Esegue processi personalizzati aggiuntivi durante la convalida di un valore.
ReadOnly(SiteMapNodeCollection)	Restituisce una raccolta di sola lettura che contiene i nodi nella raccolta SiteMapNodeCollection specificata.
Remove(SiteMapNode)	Rimuove l'oggetto SiteMapNode specificato dalla raccolta.
RemoveAt(Int32)	Rimuove l'oggetto in corrispondenza dell'indice SiteMapNode specificato dell'insieme SiteMapNodeCollection .
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32)	Copia gli elementi dell'interfaccia ICollection in una matrice, a partire da un determinato indice di matrice. La classe non può essere ereditata.
ICollection.Count	Ottiene il numero degli elementi contenuti nell'interfaccia ICollection. La classe non può essere ereditata.
ICollection.IsSynchronized	Ottiene un valore `Boolean` che indica se l'accesso all'interfaccia ICollection è sincronizzato (thread-safe). La classe non può essere ereditata.
ICollection.SyncRoot	Ottiene un oggetto che può essere usato per sincronizzare l'accesso all'interfaccia ICollection. La classe non può essere ereditata.
IEnumerable.GetEnumerator()	Restituisce un enumeratore che consente di eseguire l'iterazione di una raccolta. Per una descrizione di questo membro, vedere GetEnumerator().
IHierarchicalEnumerable.GetHierarchyData(Object)	Restituisce un elemento di dati gerarchici per l'elemento enumerato specificato. Per una descrizione di questo membro, vedere GetHierarchyData(Object).
IList.Add(Object)	Aggiunge un elemento alla raccolta nell'interfaccia IList. Per una descrizione di questo membro, vedere Add(Object).
IList.Clear()	Rimuove tutti gli elementi dalla raccolta nell'interfaccia IList. Per una descrizione di questo membro, vedere Clear().
IList.Contains(Object)	Determina se la raccolta dell'interfaccia IList contiene il valore booleano specificato.
IList.IndexOf(Object)	Determina l'indice dell'elemento specifico della raccolta che viene restituito dall'interfaccia IList. Per una descrizione di questo membro, vedere IndexOf(Object).
IList.Insert(Int32, Object)	Consente di inserire un elemento nella raccolta dell'interfaccia IList, in corrispondenza dell'indice specificato. Per una descrizione di questo membro, vedere Insert(Int32, Object).
IList.IsFixedSize	Ottiene un valore che indica se la dimensione della raccolta `Boolean` è fissa. Per una descrizione di questo membro, vedere IsFixedSize.
IList.IsReadOnly	Ottiene un valore `Boolean` che indica se la raccolta è di sola lettura. Per una descrizione di questo membro, vedere IsReadOnly.
IList.Item[Int32]	Ottiene l'elemento IList in corrispondenza dell'indice specificato.
IList.Remove(Object)	Rimuove la prima ricorrenza di un oggetto specificato dalla raccolta nell'interfaccia IList. Per una descrizione di questo membro, vedere Remove(Object).
IList.RemoveAt(Int32)	Rimuove l'elemento IList in corrispondenza dell'indice specificato. Per una descrizione di questo membro, vedere RemoveAt(Int32).

Metodi di estensione

Cast<TResult>(IEnumerable)	Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.
OfType<TResult>(IEnumerable)	Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)	Consente la parallelizzazione di una query.
AsQueryable(IEnumerable)	Converte un oggetto IEnumerable in un oggetto IQueryable.

Si applica a