SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) Método

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

Devuelve una colección de sólo lectura que contiene los nodos de la colección SiteMapNodeCollection especificada.

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

SiteMapNodeCollection que contiene los objetos SiteMapNode que se van a agregar a la colección SiteMapNodeCollection de sólo lectura.

Devoluciones

SiteMapNodeCollection

SiteMapNodeCollection de sólo lectura con los mismos elementos SiteMapNode y estructura que la colección SiteMapNodeCollection original.

Excepciones

ArgumentNullException

collection es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la IsReadOnly propiedad para probar si una SiteMapNodeCollection colección es de solo lectura o modificable. Si siteNodes es modificable, MoveNode se llama a en él; de lo contrario, se crea un clon SiteMapNodeCollection , utilizando 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

Comentarios

Para probar si una SiteMapNodeCollection colección es de solo lectura, compruebe la IsReadOnly propiedad . La IsFixedSize propiedad también devuelve true cuando es de SiteMapNodeCollection solo lectura.

Notas a los desarrolladores de herederos

Una colección de solo SiteMapNodeCollection lectura admite operaciones de lectura y búsqueda, pero no admite los Add(SiteMapNode)métodos , AddRange, Clear()Insert(Int32, SiteMapNode), Remove(SiteMapNode), y RemoveAt(Int32) , ni el establecedor en la propiedad del indexador predeterminado, Item[Int32].