Freigeben über


SiteMapNodeCollection Konstruktoren

Definition

Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse.

Überlädt

Name Beschreibung
SiteMapNodeCollection()

Initialisiert eine neue Instanz der SiteMapNodeCollection Klasse, bei der es sich um die Standardinstanz handelt.

SiteMapNodeCollection(Int32)

Initialisiert eine neue Instanz der SiteMapNodeCollection Klasse mit der angegebenen Anfangskapazität.

SiteMapNodeCollection(SiteMapNode)

Initialisiert eine neue Instanz der SiteMapNodeCollection Klasse und fügt das SiteMapNode Objekt der InnerList Eigenschaft für die Auflistung hinzu.

SiteMapNodeCollection(SiteMapNode[])

Initialisiert eine neue Instanz der SiteMapNodeCollection Klasse und fügt das Array des Typs SiteMapNode der InnerList Eigenschaft für die Auflistung hinzu.

SiteMapNodeCollection(SiteMapNodeCollection)

Initialisiert eine neue Instanz der SiteMapNodeCollection Klasse und fügt alle Listenelemente der angegebenen SiteMapNodeCollection Auflistung der InnerList Eigenschaft für die Auflistung hinzu.

SiteMapNodeCollection()

Initialisiert eine neue Instanz der SiteMapNodeCollection Klasse, bei der es sich um die Standardinstanz handelt.

public:
 SiteMapNodeCollection();
public SiteMapNodeCollection();
Public Sub New ()

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der SiteMapNodeCollection Konstruktor zum Erstellen einer neuen SiteMapNodeCollection Auflistung verwendet wird, und anschließend der Methode Add Elemente SiteMapNodeCollection hinzufügen.

// The LoadSiteMapData() method loads site navigation
// data from persistent storage into a DataTable.
DataTable siteMap = LoadSiteMapData();

// Create a SiteMapNodeCollection.
SiteMapNodeCollection nodes = new SiteMapNodeCollection();

// Create a SiteMapNode and add it to the collection.
SiteMapNode tempNode;
DataRow row;
int index = 0;

while (index < siteMap.Rows.Count)
{

    row = siteMap.Rows[index];

    // Create a node based on the data in the DataRow.
    tempNode = new SiteMapNode(SiteMap.Provider,
                                row["Key"].ToString(),
                                row["Url"].ToString());

    // Add the node to the collection.
    nodes.Add(tempNode);
    ++index;
}
' The LoadSiteMapData() Function loads site navigation
' data from persistent storage into a DataTable.

Dim siteMapData As DataTable
siteMapData = LoadSiteMapData()

' Create a SiteMapNodeCollection.
Dim nodes As New SiteMapNodeCollection()

' Create a SiteMapNode and add it to the collection.
Dim tempNode As SiteMapNode
Dim row As DataRow
Dim index As Integer
index = 0

While (index < siteMapData.Rows.Count)

    row = siteMapData.Rows(index)

    ' Create a node based on the data in the DataRow.
    tempNode = New SiteMapNode(SiteMap.Provider, row("Key").ToString(), row("Url").ToString())

    ' Add the node to the collection.
    nodes.Add(tempNode)
    index = index + 1
End While

Hinweise

Verwenden Sie den SiteMapNodeCollection Konstruktor, um eine leere SiteMapNodeCollection Auflistung zu erstellen. Sie können elemente zur Verwendung der SiteMapNodeCollectionAddMethode AddRangehinzufügen Insert .

Weitere Informationen

Gilt für:

SiteMapNodeCollection(Int32)

Initialisiert eine neue Instanz der SiteMapNodeCollection Klasse mit der angegebenen Anfangskapazität.

public:
 SiteMapNodeCollection(int capacity);
public SiteMapNodeCollection(int capacity);
new System.Web.SiteMapNodeCollection : int -> System.Web.SiteMapNodeCollection
Public Sub New (capacity As Integer)

Parameter

capacity
Int32

Die Anfangskapazität der SiteMapNodeCollection.

Hinweise

Verwenden Sie den SiteMapNodeCollection Konstruktor, um eine SiteMapNodeCollection Auflistung mit der angegebenen Anfangskapazität zu erstellen.

Weitere Informationen

Gilt für:

SiteMapNodeCollection(SiteMapNode)

Initialisiert eine neue Instanz der SiteMapNodeCollection Klasse und fügt das SiteMapNode Objekt der InnerList Eigenschaft für die Auflistung hinzu.

public:
 SiteMapNodeCollection(System::Web::SiteMapNode ^ value);
public SiteMapNodeCollection(System.Web.SiteMapNode value);
new System.Web.SiteMapNodeCollection : System.Web.SiteMapNode -> System.Web.SiteMapNodeCollection
Public Sub New (value As SiteMapNode)

Parameter

value
SiteMapNode

A SiteMapNode zum Hinzufügen zur SiteMapNodeCollection.

Ausnahmen

value ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Auflistung mit einem einzelnen anfangsobjekt erstellt und anschließend mithilfe der Methode ein Objekt von Objekten hinzugefügt wird.The following code example demonstrates how to create a SiteMapNodeCollection collection with a single initial SiteMapNode object, and then add a SiteMapNodeCollection of SiteMapNode objects to it using the AddRange method. Sie können die SiteMapNodeCollectionObjekte ändern, obwohl die einzelnen SiteMapNode Objekte möglicherweise schreibgeschützt sind.


// Create a SiteMapNodeCollection with all the nodes
// from the first two hierarchical levels of the current
// site map.
SiteMapNodeCollection baseCollection =
    new SiteMapNodeCollection(SiteMap.RootNode);

SiteMapNodeCollection childCollection =
    SiteMap.RootNode.ChildNodes;

baseCollection.AddRange(childCollection);

Response.Write( "<BR>Derived SiteMapNodeCollection.<BR><HR><BR>");
foreach (SiteMapNode node in baseCollection) {
    Response.Write( node.Title + "<BR>");
}

' Create a SiteMapNodeCollection with all the nodes
' from the first two hierarchical levels of the current
' site map.
Dim baseCollection As SiteMapNodeCollection
baseCollection = New SiteMapNodeCollection(SiteMap.RootNode)

Dim childCollection As SiteMapNodeCollection = SiteMap.RootNode.ChildNodes

baseCollection.AddRange(childCollection)

Response.Write( "<BR>Derived SiteMapNodeCollection.<BR><HR><BR>")

For Each node In baseCollection
    Response.Write( node.Title + "<BR>")
Next

Hinweise

Verwenden Sie den SiteMapNodeCollection Konstruktor, um eine SiteMapNodeCollection Auflistung mit einem einzelnen anfänglichen SiteMapNode Objekt zu erstellen. Sie können elemente zur Verwendung der SiteMapNodeCollectionAddMethode AddRangehinzufügen Insert .

Weitere Informationen

Gilt für:

SiteMapNodeCollection(SiteMapNode[])

Initialisiert eine neue Instanz der SiteMapNodeCollection Klasse und fügt das Array des Typs SiteMapNode der InnerList Eigenschaft für die Auflistung hinzu.

public:
 SiteMapNodeCollection(cli::array <System::Web::SiteMapNode ^> ^ value);
public SiteMapNodeCollection(System.Web.SiteMapNode[] value);
new System.Web.SiteMapNodeCollection : System.Web.SiteMapNode[] -> System.Web.SiteMapNodeCollection
Public Sub New (value As SiteMapNode())

Parameter

value
SiteMapNode[]

Ein Array vom Typ SiteMapNode , das dem Add-In hinzugefügt SiteMapNodeCollectionwerden soll.

Ausnahmen

value ist null.

Hinweise

Die Verwendung des Konstruktors entspricht dem SiteMapNodeCollection Aufrufen des SiteMapNodeCollection Konstruktors und dem Hinzufügen von Elementen zur SiteMapNodeCollection Auflistung mit der AddRange Methode.

Weitere Informationen

Gilt für:

SiteMapNodeCollection(SiteMapNodeCollection)

Initialisiert eine neue Instanz der SiteMapNodeCollection Klasse und fügt alle Listenelemente der angegebenen SiteMapNodeCollection Auflistung der InnerList Eigenschaft für die Auflistung hinzu.

public:
 SiteMapNodeCollection(System::Web::SiteMapNodeCollection ^ value);
public SiteMapNodeCollection(System.Web.SiteMapNodeCollection value);
new System.Web.SiteMapNodeCollection : System.Web.SiteMapNodeCollection -> System.Web.SiteMapNodeCollection
Public Sub New (value As SiteMapNodeCollection)

Parameter

value
SiteMapNodeCollection

Ein SiteMapNodeCollection Objekt, das das SiteMapNode zum aktuellen SiteMapNodeCollectionElement hinzugefügt werden soll.

Ausnahmen

value ist null.

Beispiele

Im folgenden Codebeispiel wird das Erstellen einer Auflistung mithilfe eines SiteMapNodeCollection anderen SiteMapNodeCollection Objekts SiteMapNode als Basis veranschaulicht. Die SiteMapNode.GetAllNodes Methode gibt einen schreibgeschützten SiteMapNodeCollectionWert zurück, der beim Zurückgeben trueder IsReadOnly Eigenschaft erkannt wird. Ein neues SiteMapNodeCollection wird mithilfe des schreibgeschützten SiteMapNodeCollection Elements erstellt, und die Add Methoden Remove können erfolgreich aufgerufen werden.

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

Hinweise

Die Verwendung des Konstruktors entspricht dem SiteMapNodeCollection Aufrufen des SiteMapNodeCollection Konstruktors und dem Hinzufügen von Elementen zur SiteMapNodeCollection Auflistung mit der AddRange Methode.

Gilt für: