SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) Yöntem

Tanım

Ad Alanı:

System.Web

Bütünleştirilmiş Kod:

System.Web.dll

Belirtilen SiteMapNodeCollection koleksiyondaki düğümleri içeren salt okunur bir koleksiyon döndürür.

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

Parametreler

collection

SiteMapNodeCollection

SiteMapNodeCollection salt okunur SiteMapNodeCollectionöğesine eklenecek nesneleri içeren SiteMapNode .

Döndürülenler

SiteMapNodeCollection

Özgün SiteMapNodeCollectionile aynı SiteMapNode öğelere ve yapıya sahip salt SiteMapNodeCollection okunur.

Özel durumlar

ArgumentNullException

collection, null değeridir.

Örnekler

Aşağıdaki kod örneği, bir SiteMapNodeCollection koleksiyonun IsReadOnly salt okunur mu yoksa değiştirilebilir mi olduğunu test etmek için özelliğinin nasıl kullanılacağını gösterir. DeğiştirilebilirsesiteNodes, MoveNode üzerinde çağrılır; aksi takdirde, temel olarak kullanılarak siteNodes bir kopya SiteMapNodeCollection oluşturulur.

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

Açıklamalar

Özelliğini denetleyerek IsReadOnly bir SiteMapNodeCollection koleksiyonun salt okunur olup olmadığını test edebilirsiniz. özelliğiIsFixedSize, salt okunur olduğunda SiteMapNodeCollection da döndürürtrue.

Devralanlara Notlar

Salt SiteMapNodeCollection okunur koleksiyon okuma ve arama işlemlerini destekler, ancak , AddRange, Clear(), Insert(Int32, SiteMapNode), Remove(SiteMapNode)ve RemoveAt(Int32) yöntemlerini veya varsayılan dizin oluşturucu özelliğindeki ayarlayıcıyı desteklemezAdd(SiteMapNode). Item[Int32]