SiteMapNodeCollection Classe

Référence

Définition

Espace de noms:: System.Web

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Fournit une collection fortement typée pour des objets SiteMapNode et implémente l’interface IHierarchicalEnumerable pour prendre en charge la navigation dans la 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

Héritage: Object
SiteMapNodeCollection

Implémente: ICollection IEnumerable IList IHierarchicalEnumerable

Exemples

L’exemple de code suivant montre comment créer une SiteMapNodeCollection collection, puis y ajouter SiteMapNode des objets à l’aide de la AddRange méthode. Il SiteMapNodeCollection s’agit d’un sous-ensemble de la carte de site actuelle, affichant uniquement les deux premiers niveaux hiérarchiques.


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

Remarques

La SiteMapNodeCollection classe fournit une collection fortement typée pour SiteMapNode les objets. Il stocke les SiteMapNode objets en interne dans un tableau de base zéro.

Vous pouvez modifier une SiteMapNodeCollection collection lors de sa création, puis utiliser les méthodes suivantes pour ajouter, copier et supprimer SiteMapNode des objets :

Pour ajouter des SiteMapNode objets, utilisez les méthodes et Insert les Add AddRangeméthodes.
Pour copier des SiteMapNode objets, utilisez la CopyTo méthode.
Pour supprimer des SiteMapNode objets, utilisez la Remove méthode.

Vous pouvez créer un objet en lecture seule SiteMapNodeCollection, qui n’autorise pas l’ajout, la copie et la suppression d’objets SiteMapNode à l’aide de la méthode statique ReadOnly . Les SiteMapNodeCollection collections retournées par les méthodes et GetChildren les SiteMapNode.GetAllNodes méthodes sont en lecture seule, comme c’est le SiteMapNodeCollection cas lorsque la ChildNodes propriété est accessible sur un SiteMapNode objet retourné par un fournisseur. Une NotSupportedException exception est levée si vous tentez de modifier une valeur en lecture seule SiteMapNodeCollection en définissant la propriété d’indexeur par défaut ou en utilisant l’une des méthodes suivantes :

Utilisez la IsReadOnly propriété pour vérifier la collection avant d’appeler l’une des méthodes de la liste précédente.

Constructeurs

SiteMapNodeCollection()	Initialise une nouvelle instance de la classe SiteMapNodeCollection qui constitue l'instance par défaut.
SiteMapNodeCollection(Int32)	Initialise une nouvelle instance de la classe SiteMapNodeCollection avec la capacité initiale par défaut.
SiteMapNodeCollection(SiteMapNode)	Initialise une nouvelle instance de la classe SiteMapNodeCollection et ajoute l'objet SiteMapNode à la propriété InnerList pour la collection.
SiteMapNodeCollection(SiteMapNode[])	Initialise une nouvelle instance de la classe SiteMapNodeCollection et ajoute le tableau de type SiteMapNode à la propriété InnerList pour la collection.
SiteMapNodeCollection(SiteMapNodeCollection)	Initialise une nouvelle instance de la classe SiteMapNodeCollection et ajoute tous les éléments de liste de la collection SiteMapNodeCollection spécifiée à la propriété InnerList pour la collection.

Propriétés

Count	Obtient le nombre d’éléments contenus dans la collection.
IsFixedSize	Obtient une valeur Boolean qui indique si des nœuds peuvent être ajoutés à la collection ou soustraits à celle-ci.
IsReadOnly	Obtient une valeur Boolean indiquant si la collection est en lecture seule.
IsSynchronized	Obtient une valeur Boolean qui indique si l'accès à la collection est synchronisé (de type thread-safe).
Item[Int32]	Obtient ou définit l'objet SiteMapNode à l'index spécifié dans la collection.
SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à la collection.

Méthodes

Add(SiteMapNode)	Ajoute un objet unique SiteMapNode à la SiteMapNodeCollection collection.
AddRange(SiteMapNode[])	Ajoute un tableau de type SiteMapNode à la collection.
AddRange(SiteMapNodeCollection)	Ajoute les nœuds de la classe SiteMapNodeCollection spécifiée dans la collection actuelle.
Clear()	Supprime tous les éléments de la collection.
Contains(SiteMapNode)	Détermine si la collection contient un objet SiteMapNode spécifique.
CopyTo(SiteMapNode[], Int32)	Copie la collection entière vers un tableau unidimensionnel compatible en commençant à l'index spécifié du tableau cible.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetDataSourceView(SiteMapDataSource, String)	Récupère l'objet SiteMapDataSourceView associé aux nœuds présents dans la collection actuelle.
GetEnumerator()	Récupère une référence à un objet d'énumérateur utilisé pour itérer au sein de la collection.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetHierarchicalDataSourceView()	Récupère l'objet SiteMapHierarchicalDataSourceView associé aux nœuds présents dans la collection actuelle.
GetHierarchyData(Object)	Retourne un élément de données hiérarchiques pour l’élément énuméré spécifié.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IndexOf(SiteMapNode)	Recherche l'objet SiteMapNode spécifié, puis retourne l'index de base zéro de la première occurrence dans l'ensemble de la collection.
Insert(Int32, SiteMapNode)	Insère l'objet SiteMapNode indiqué dans la collection à l'index spécifié.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnValidate(Object)	Exécute des processus personnalisés supplémentaires lors de la validation d'une valeur.
ReadOnly(SiteMapNodeCollection)	Retourne une collection en lecture seule qui contient les nœuds dans la collection SiteMapNodeCollection spécifiée.
Remove(SiteMapNode)	Supprime l'objet SiteMapNode spécifié de la collection.
RemoveAt(Int32)	Supprime l’objet SiteMapNode à l’index spécifié de la SiteMapNodeCollection collection.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32)	Copie les éléments de l'interface ICollection dans un tableau, en commençant au niveau d'un index de tableau particulier. Cette classe ne peut pas être héritée.
ICollection.Count	Obtient le nombre des éléments contenus dans l'interface ICollection. Cette classe ne peut pas être héritée.
ICollection.IsSynchronized	Obtient une valeur `Boolean` indiquant si l'accès à l'interface ICollection est synchronisé (thread safe). Cette classe ne peut pas être héritée.
ICollection.SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l'accès à l'interface ICollection. Cette classe ne peut pas être héritée.
IEnumerable.GetEnumerator()	Retourne un énumérateur qui itère au sein d’une collection. Pour obtenir une description de ce membre, consultez GetEnumerator().
IHierarchicalEnumerable.GetHierarchyData(Object)	Retourne un élément de données hiérarchiques pour l’élément énuméré spécifié. Pour obtenir une description de ce membre, consultez GetHierarchyData(Object).
IList.Add(Object)	Ajoute un élément à la collection dans l'interface IList. Pour obtenir une description de ce membre, consultez Add(Object).
IList.Clear()	Supprime tous les éléments de la collection dans l'interface IList. Pour obtenir une description de ce membre, consultez Clear().
IList.Contains(Object)	Détermine si la collection dans l'interface IList contient la valeur Boolean spécifiée.
IList.IndexOf(Object)	Détermine l'index de l'élément spécifique dans la collection retournée par l'interface IList. Pour obtenir une description de ce membre, consultez IndexOf(Object).
IList.Insert(Int32, Object)	Insère un élément dans la collection dans l'interface IList à l'index spécifié. Pour obtenir une description de ce membre, consultez Insert(Int32, Object).
IList.IsFixedSize	Obtient une valeur `Boolean` indiquant si la collection est de taille fixe. Pour obtenir une description de ce membre, consultez IsFixedSize.
IList.IsReadOnly	Obtient une valeur `Boolean` indiquant si la collection est en lecture seule. Pour obtenir une description de ce membre, consultez IsReadOnly.
IList.Item[Int32]	Obtient l’élément IList à l’index spécifié.
IList.Remove(Object)	Supprime la première occurrence d'un objet spécifié dans la collection dans l'interface IList. Pour obtenir une description de ce membre, consultez Remove(Object).
IList.RemoveAt(Int32)	Supprime l'élément IList au niveau de l'index spécifié. Pour obtenir une description de ce membre, consultez RemoveAt(Int32).

Méthodes d’extension

Cast<TResult>(IEnumerable)	Effectue un cast des éléments d'un IEnumerable vers le type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d'un IEnumerable en fonction du type spécifié.
AsParallel(IEnumerable)	Active la parallélisation d'une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.

S’applique à