SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) Methode

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Gibt eine schreibgeschützte Auflistung zurück, die die Knoten in der angegebenen SiteMapNodeCollection-Auflistung enthält.

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.

Gibt zurück

SiteMapNodeCollection

Eine schreibgeschützte SiteMapNodeCollection mit den gleichen SiteMapNode-Elementen und der gleichen Struktur wie die ursprüngliche SiteMapNodeCollection.

Ausnahmen

ArgumentNullException

collection ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der IsReadOnly Eigenschaft testen können, ob eine SiteMapNodeCollection Auflistung schreibgeschützt oder geändert werden kann. Wenn siteNodes sie geändert werden kann, MoveNode wird sie aufgerufen. Andernfalls wird ein Klon SiteMapNodeCollection erstellt, der siteNodes als Basis verwendet wird.

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 eine SiteMapNodeCollection Auflistung schreibgeschützt ist, indem Sie die IsReadOnly Eigenschaft überprüfen. Die IsFixedSize Eigenschaft gibt auch zurück, wenn eine SiteMapNodeCollection schreibgeschützt true ist.

Hinweise für Vererber

Eine schreibgeschützte SiteMapNodeCollection Auflistung unterstützt Lese- und Suchvorgänge, unterstützt jedoch nicht die Add(SiteMapNode), AddRange, Insert(Int32, SiteMapNode)Clear(), , Remove(SiteMapNode)und RemoveAt(Int32) Methoden, oder der Setter für die Standardindexereigenschaft, Item[Int32].