SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) Method

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

Parameters

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.

Returns

SiteMapNodeCollection

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.

Exceptions

collection ist nullcollection is null.

Examples

Im folgenden Codebeispiel wird veranschaulicht, wie die IsReadOnly-Eigenschaft verwendet wird, um zu testen, ob eine SiteMapNodeCollection Auflistung schreibgeschützt oder änderbar ist.The following code example demonstrates how to use the IsReadOnly property to test whether a SiteMapNodeCollection collection is read-only or modifiable. Wenn siteNodes änderbar ist, wird MoveNode aufgerufen. Andernfalls wird ein Klon SiteMapNodeCollection erstellt, wobei siteNodes 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

Remarks

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

Notes to Inheritors

Eine schreibgeschützte SiteMapNodeCollection Auflistung unterstützt Lese-und Suchvorgänge, unterstützt jedoch nicht die Methoden "Add(SiteMapNode)", "AddRange", "Clear()", "Insert(Int32, SiteMapNode)", "Remove(SiteMapNode)" und "RemoveAt(Int32)" sowie den Setter in der 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].

Applies to