SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) Méthode

Définition

Retourne une collection en lecture seule qui contient les nœuds dans la collection SiteMapNodeCollection spécifiée.Returns a read-only collection that contains the nodes in the specified SiteMapNodeCollection collection.

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.The SiteMapNodeCollection that contains the SiteMapNode objects to add to the read-only SiteMapNodeCollection.

Retours

SiteMapNodeCollection en lecture seule avec les mêmes éléments et structure SiteMapNode que le SiteMapNodeCollection d'origine.A read-only SiteMapNodeCollection with the same SiteMapNode elements and structure as the original SiteMapNodeCollection.

Exceptions

collection a la valeur null.collection is 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.The following code example demonstrates how to use the IsReadOnly property to test whether a SiteMapNodeCollection collection is read-only or modifiable. Si siteNodes est modifiable, MoveNode est appelé sur celui-ci; sinon, SiteMapNodeCollection un clone est siteNodes créé, en utilisant comme base.If siteNodes is modifiable, MoveNode is called on it; otherwise, a clone SiteMapNodeCollection is created, using siteNodes as a 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 IsReadOnly la propriété.You can test whether a SiteMapNodeCollection collection is read-only by checking the IsReadOnly property. La IsFixedSize propriété retourne true également lorsqu’un SiteMapNodeCollection est en lecture seule.The IsFixedSize property also returns true when a SiteMapNodeCollection is read-only.

Notes pour les héritiers

Une collection en lecture SiteMapNodeCollection seule prend en charge les opérations de lecture et de recherche, mais ne Clear()prend pas Remove(SiteMapNode)en charge RemoveAt(Int32) les Add(SiteMapNode)méthodes, AddRange,, Insert(Int32, SiteMapNode), et, ni la méthode setter sur l’indexeur par défaut. propriété, Item[Int32].A read-only SiteMapNodeCollection collection supports read and search operations, but does not support the Add(SiteMapNode), AddRange, Clear(), Insert(Int32, SiteMapNode), Remove(SiteMapNode), and RemoveAt(Int32) methods, nor the setter on the default indexer property, Item[Int32].

S’applique à