SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zwraca kolekcję tylko do odczytu zawierającą węzły w określonej SiteMapNodeCollection kolekcji.

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

Obiekt SiteMapNodeCollection zawierający SiteMapNode obiekty, które mają zostać dodane do pliku tylko SiteMapNodeCollectiondo odczytu.

Zwraca

SiteMapNodeCollection

Tylko do SiteMapNodeCollection odczytu z tymi samymi SiteMapNode elementami i strukturą co oryginalny SiteMapNodeCollectionelement .

Wyjątki

ArgumentNullException

collection to null.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać IsReadOnly właściwości do testowania, czy kolekcja jest tylko do odczytu, czy SiteMapNodeCollection modyfikowalna. Jeśli siteNodes element jest modyfikowalny, MoveNode jest wywoływany. W przeciwnym razie zostanie utworzony klon SiteMapNodeCollection , używając go siteNodes jako podstawy.

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

Uwagi

Możesz sprawdzić, czy SiteMapNodeCollection kolekcja jest tylko do odczytu, sprawdzając IsReadOnly właściwość. Właściwość IsFixedSize zwraca również wartość true , gdy element SiteMapNodeCollection jest tylko do odczytu.

Uwagi dotyczące dziedziczenia

Kolekcja tylko do SiteMapNodeCollection odczytu obsługuje operacje odczytu i wyszukiwania, ale nie obsługuje Add(SiteMapNode)metod , AddRange, Insert(Int32, SiteMapNode)Clear(), , Remove(SiteMapNode)i RemoveAt(Int32) ani ustawiania dla domyślnej właściwości indeksatora, Item[Int32].

Dotyczy