SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) Metode

Definisi

Ruang nama:

System.Web

Rakitan:

System.Web.dll

Mengembalikan koleksi baca-saja yang berisi simpul dalam koleksi yang ditentukan SiteMapNodeCollection .

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 yang berisi SiteMapNode objek yang akan ditambahkan ke baca-saja SiteMapNodeCollection.

Mengembalikan

SiteMapNodeCollection

Baca-saja SiteMapNodeCollection dengan elemen dan struktur yang sama SiteMapNode dengan aslinya SiteMapNodeCollection.

Pengecualian

ArgumentNullException

collection adalah null.

Contoh

Contoh kode berikut menunjukkan cara menggunakan IsReadOnly properti untuk menguji apakah SiteMapNodeCollection koleksi bersifat baca-saja atau dapat dimodifikasi. Jika siteNodes dapat dimodifikasi, MoveNode dipanggil di atasnya; jika tidak, kloning SiteMapNodeCollection dibuat, menggunakan siteNodes sebagai dasar.

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

Keterangan

Anda dapat menguji apakah SiteMapNodeCollection koleksi bersifat baca-saja dengan memeriksa IsReadOnly properti . Properti IsFixedSize juga mengembalikan true saat SiteMapNodeCollection baca-saja.

Catatan Bagi Inheritor

Koleksi baca-saja SiteMapNodeCollection mendukung operasi baca dan cari, tetapi tidak mendukung Add(SiteMapNode)metode , , AddRange, Clear()Insert(Int32, SiteMapNode), Remove(SiteMapNode), dan RemoveAt(Int32) , atau setter pada properti pengindeks default, Item[Int32].