SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) Metoda

Reference

Definice

Obor názvů:: System.Web

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vrátí kolekci 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

Obsahující SiteMapNodeCollection objekty, které SiteMapNode se mají 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, jak použít IsReadOnly vlastnost testovat, zda SiteMapNodeCollection je kolekce jen pro čtení nebo upravitelná. Pokud siteNodes je možné ji upravit, MoveNode volá se na ni. V opačném případě 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

Můžete otestovat, jestli je kolekce jen pro čtení, a to tak, že SiteMapNodeCollection vlastnost zkontrolujete IsReadOnly . 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)operace , , AddRange, Clear(), Insert(Int32, SiteMapNode), Remove(SiteMapNode), a RemoveAt(Int32) metody, ani setter u výchozí vlastnosti indexeru, Item[Int32].

Platí pro