SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) Méthode

Définition

Espace de noms:

System.Web

Assembly:

System.Web.dll

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]