SiteMapNodeCollection.ReadOnly(SiteMapNodeCollection) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een alleen-lezen verzameling die de knooppunten in de opgegeven SiteMapNodeCollection verzameling bevat.
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.SiteMapNodeCollectionPublic Shared Function ReadOnly (collection As SiteMapNodeCollection) As SiteMapNodeCollectionParameters
- collection
- SiteMapNodeCollection
De SiteMapNodeCollection objecten die SiteMapNode moeten worden toegevoegd aan het kenmerk Alleen-lezen SiteMapNodeCollection.
Retouren
Een alleen-lezen SiteMapNodeCollection met dezelfde SiteMapNode elementen en structuur als het origineel SiteMapNodeCollection.
Uitzonderingen
collection is null.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de IsReadOnly eigenschap gebruikt om te testen of een SiteMapNodeCollection verzameling alleen-lezen is of kan worden gewijzigd. Als siteNodes dit kan worden gewijzigd, wordt er een aangeroepen. MoveNode Anders wordt er een kloon SiteMapNodeCollection gemaakt met behulp van siteNodes als basis.
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
Opmerkingen
U kunt testen of een SiteMapNodeCollection verzameling alleen-lezen is door de IsReadOnly eigenschap te controleren. De IsFixedSize eigenschap retourneert true ook wanneer een SiteMapNodeCollection kenmerk alleen-lezen is.
Notities voor overnemers
Een alleen-lezenverzameling SiteMapNodeCollection ondersteunt lees- en zoekbewerkingen, maar biedt geen ondersteuning voor de Add(SiteMapNode)methoden , , AddRangeClear(), Insert(Int32, SiteMapNode)en Remove(SiteMapNode)RemoveAt(Int32) methoden, noch de setter voor de standaardindexeerfunctieeigenschap, Item[Int32].
