SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) Méthode

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.

Retourne une collection en lecture seule qui contient les nœuds dans la collection SiteMapNodeCollection spécifiée.

public:
 static System::Web::SiteMapNodeCollection ^ ReadOnly(System::Web::SiteMapNodeCollection ^ collection);

public static System.Web.SiteMapNodeCollection ReadOnly (System.Web.SiteMapNodeCollection collection);

static member ReadOnly : System.Web.SiteMapNodeCollection -> System.Web.SiteMapNodeCollection

Public Shared Function ReadOnly (collection As SiteMapNodeCollection) As SiteMapNodeCollection

Paramètres

collection: SiteMapNodeCollection

SiteMapNodeCollection qui contient les objets SiteMapNode à ajouter au SiteMapNodeCollection en lecture seule.

Retours

SiteMapNodeCollection

SiteMapNodeCollection en lecture seule avec les mêmes éléments et structure SiteMapNode que le SiteMapNodeCollection d'origine.

Exceptions

ArgumentNullException

collection a la valeur null.

Exemples

L’exemple de code suivant montre comment utiliser la IsReadOnly propriété pour tester si une SiteMapNodeCollection collection est en lecture seule ou modifiable. Si siteNodes elle est modifiable, MoveNode elle est appelée ; sinon, un clone SiteMapNodeCollection est créé, à l’aide siteNodes d’une base.

SiteMapNodeCollection siteNodes = SiteMap.RootNode.GetAllNodes();

if ( siteNodes.IsReadOnly ||
     siteNodes.IsFixedSize )
{
    Response.Write("Collection is read-only or has fixed size.<BR>");

    // Create a new, modifiable collection from the existing one.
    SiteMapNodeCollection modifiableCollection =
         new SiteMapNodeCollection(siteNodes);

    // The MoveNode example method moves a node from position one to
    // the last position in the collection.
    MoveNode(modifiableCollection);
}
else {
    MoveNode(siteNodes);
}

Dim siteNodes As SiteMapNodeCollection
siteNodes = SiteMap.RootNode.GetAllNodes()

If siteNodes.IsReadOnly Or siteNodes.IsFixedSize Then

    Response.Write("Collection is read-only or has fixed size.<BR>")

    ' Create a new, modifiable collection from the existing one.
    Dim modifiableCollection As SiteMapNodeCollection
    modifiableCollection = New SiteMapNodeCollection(siteNodes)

    ' The MoveNode example method moves a node from position one to
    ' the last position in the collection.
    MoveNode(modifiableCollection)
Else
    MoveNode(siteNodes)
End If

Remarques

Vous pouvez tester si une SiteMapNodeCollection collection est en lecture seule en vérifiant la IsReadOnly propriété. La IsFixedSize propriété retourne true également lorsqu’une SiteMapNodeCollection valeur est en lecture seule.

Notes pour les héritiers

Une collection en lecture seule SiteMapNodeCollection prend en charge les opérations de lecture et de recherche, mais ne prend pas en charge les Add(SiteMapNode)méthodes , , AddRangeet Clear()Remove(SiteMapNode)Insert(Int32, SiteMapNode)RemoveAt(Int32) non le setter sur la propriété d’indexeur par défaut. Item[Int32]

S’applique à

Partager via