SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) Metodo

Definizione

Spazio dei nomi:

System.Web

Assembly:

System.Web.dll

Restituisce una raccolta di sola lettura che contiene i nodi nella raccolta SiteMapNodeCollection specificata.

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

Parametri

collection

SiteMapNodeCollection

Elemento SiteMapNodeCollection che contiene gli oggetti SiteMapNode da aggiungere all'elemento SiteMapNodeCollection di sola lettura.

Restituisce

SiteMapNodeCollection

Elemento SiteMapNodeCollection di sola lettura con gli stessi elementi SiteMapNode e la stessa struttura dell'elemento SiteMapNodeCollection originale.

Eccezioni

ArgumentNullException

collection è null.

Esempio

Nell'esempio di codice seguente viene illustrato come usare la IsReadOnly proprietà per verificare se una SiteMapNodeCollection raccolta è di sola lettura o modificabile. Se siteNodes è modificabile, viene chiamato su di esso; in caso contrario, MoveNode viene creato un clone SiteMapNodeCollection usando siteNodes come 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

Commenti

È possibile verificare se una SiteMapNodeCollection raccolta è di sola lettura controllando la IsReadOnly proprietà. La IsFixedSize proprietà restituisce true anche quando un SiteMapNodeCollection oggetto è di sola lettura.

Note per gli eredi

Una raccolta di sola SiteMapNodeCollection lettura supporta operazioni di lettura e ricerca, ma non supporta i Add(SiteMapNode)metodi , Clear()AddRangeRemove(SiteMapNode)Insert(Int32, SiteMapNode)e RemoveAt(Int32) , né il setter nella proprietà del indicizzatore predefinito, . Item[Int32]