SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) Metoda

Definicja

Przestrzeń nazw:

System.Web

Zestaw:

System.Web.dll

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].