SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) Methode

Definition

Gibt eine schreibgeschützte Auflistung zurück, die die Knoten in der angegebenen SiteMapNodeCollection-Auflistung enthält.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

Parameter

collection
SiteMapNodeCollection

Die SiteMapNodeCollection, die die SiteMapNode-Objekte enthält, die der schreibgeschützten SiteMapNodeCollection hinzugefügt werden sollen.The SiteMapNodeCollection that contains the SiteMapNode objects to add to the read-only SiteMapNodeCollection.

Gibt zurück

Eine schreibgeschützte SiteMapNodeCollection mit den gleichen SiteMapNode-Elementen und der gleichen Struktur wie die ursprüngliche SiteMapNodeCollection.A read-only SiteMapNodeCollection with the same SiteMapNode elements and structure as the original SiteMapNodeCollection.

Ausnahmen

collection ist null.collection is null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die IsReadOnly -Eigenschaft verwendet wird, SiteMapNodeCollection um zu testen, ob eine Auflistung schreibgeschützt ist oder geändert werden kann.The following code example demonstrates how to use the IsReadOnly property to test whether a SiteMapNodeCollection collection is read-only or modifiable. Wenn siteNodes geändert werden kann, MoveNode wird für das-Element aufgerufen; andernfalls wird SiteMapNodeCollection ein Klon erstellt, siteNodes der als Basis verwendet wird.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

Hinweise

Sie können testen, ob SiteMapNodeCollection eine Auflistung schreibgeschützt ist, indem Sie IsReadOnly die-Eigenschaft überprüfen.You can test whether a SiteMapNodeCollection collection is read-only by checking the IsReadOnly property. Die IsFixedSize -Eigenschaft gibt true auch dann SiteMapNodeCollection zurück, wenn eine schreibgeschützt ist.The IsFixedSize property also returns true when a SiteMapNodeCollection is read-only.

Hinweise für Vererber

Eine schreibgeschützte Auflistung SiteMapNodeCollection unterstützt Lese-und Suchvorgänge, Add(SiteMapNode)unterstützt jedoch nicht die AddRangeMethoden Clear(), Insert(Int32, SiteMapNode), Remove(SiteMapNode),, RemoveAt(Int32) und sowie den Setter für den Standardindexer. Eigenschaft, 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].

Gilt für: