SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) 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

Parameter

collection
SiteMapNodeCollection SiteMapNodeCollection SiteMapNodeCollection 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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mit der IsReadOnly Eigenschaft, um zu testen, ob eine SiteMapNodeCollection Auflistung ist schreibgeschützt oder bearbeitbar.The following code example demonstrates how to use the IsReadOnly property to test whether a SiteMapNodeCollection collection is read-only or modifiable. Wenn siteNodes kann geändert werden, MoveNode wird es aufgerufen wird, andernfalls ein Klon SiteMapNodeCollection erstellt haben, wird die mit siteNodes als Basis.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 eine SiteMapNodeCollection Auflistung ist schreibgeschützt, indem Sie überprüfen die IsReadOnly Eigenschaft.You can test whether a SiteMapNodeCollection collection is read-only by checking the IsReadOnly property. Die IsFixedSize Eigenschaft auch zurückgibt true bei einer SiteMapNodeCollection ist schreibgeschützt.The IsFixedSize property also returns true when a SiteMapNodeCollection is read-only.

Hinweise für Vererber

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

Gilt für: