SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) Método

Definição

Espaço de Nomes:
System.Web
Assemblagem:
System.Web.dll

Devolve uma coleção de apenas leitura que contém os nós da coleção especificada SiteMapNodeCollection .

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

Parâmetros

collection
SiteMapNodeCollection

O SiteMapNodeCollection que contém os SiteMapNode objetos a adicionar ao somente SiteMapNodeCollectionde leitura .

Devoluções

SiteMapNodeCollection

Um somente SiteMapNodeCollection de leitura com os mesmos SiteMapNode elementos e estrutura do original SiteMapNodeCollection.

Exceções

ArgumentNullException

collection é null.

Exemplos

O seguinte exemplo de código demonstra como usar a IsReadOnly propriedade para testar se uma SiteMapNodeCollection coleção é apenas de leitura ou modificável. Se siteNodes for modificável, MoveNode é chamado sobre ele; caso contrário, é criado um clone SiteMapNodeCollection , usando siteNodes como base.

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

Observações

Pode testar se uma SiteMapNodeCollection coleção é apenas de leitura verificando a IsReadOnly propriedade. A IsFixedSize propriedade também devolve true quando a SiteMapNodeCollection é apenas leitura.

Notas para Herdeiros

Uma coleção apenas SiteMapNodeCollection de leitura suporta operações de leitura e pesquisa, mas não suporta os Add(SiteMapNode), AddRange, Clear(), Insert(Int32, SiteMapNode), Remove(SiteMapNode), e RemoveAt(Int32) métodos, nem o configurador na propriedade padrão do indexador, Item[Int32].

Aplica-se a