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

Das SiteMapNodeCollection Objekt, das die SiteMapNode Objekte enthält, die dem schreibgeschützten SiteMapNodeCollectionObjekt hinzugefügt werden sollen.

Gibt zurück

SiteMapNodeCollection

Schreibgeschützt SiteMapNodeCollection mit denselben SiteMapNode Elementen und Strukturen wie das Original SiteMapNodeCollection.

Ausnahmen

ArgumentNullException

collection ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die IsReadOnly Eigenschaft verwendet wird, um zu testen, 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 true , wenn eine SiteMapNodeCollection schreibgeschützt ist.

Hinweise für Vererber

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