SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Vrátí kolekci určenou jen pro čtení, která obsahuje uzly v zadané SiteMapNodeCollection kolekci.

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

Parametry

collection

SiteMapNodeCollection

Obsahuje SiteMapNodeCollection objekty, které SiteMapNode chcete přidat do jen SiteMapNodeCollectionpro čtení .

Návraty

SiteMapNodeCollection

Jen pro čtení SiteMapNodeCollection se stejnými SiteMapNode prvky a strukturou jako původní SiteMapNodeCollection.

Výjimky

ArgumentNullException

collection je null.

Příklady

Následující příklad kódu ukazuje použití IsReadOnly vlastnosti k testování, zda SiteMapNodeCollection kolekce je jen pro čtení nebo upravitelné. Pokud siteNodes je možné ji upravit, MoveNode volá se v ní; jinak se vytvoří klon SiteMapNodeCollection , který se použije siteNodes jako základ.

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

Poznámky

Kontrolu vlastnosti můžete otestovat, zda SiteMapNodeCollection je kolekce určena jen pro IsReadOnly čtení. Vlastnost IsFixedSize také vrátí true , když SiteMapNodeCollection je jen pro čtení.

Poznámky pro dědice

Kolekce jen pro SiteMapNodeCollection čtení podporuje operace čtení a vyhledávání, ale nepodporuje Add(SiteMapNode), AddRange, Clear(), Insert(Int32, SiteMapNode), Remove(SiteMapNode), a metody, RemoveAt(Int32) ani setter ve výchozí indexer vlastnost, Item[Int32].