SiteMapNodeCollection Konstruktoren

Definition

Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse.Initializes a new instance of the SiteMapNodeCollection class.

Überlädt

SiteMapNodeCollection()

Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse, bei der es sich um die Standardinstanz handelt.Initializes a new instance of the SiteMapNodeCollection class, which is the default instance.

SiteMapNodeCollection(Int32)

Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse mit der angegebenen anfänglichen Kapazität.Initializes a new instance of the SiteMapNodeCollection class with the specified initial capacity.

SiteMapNodeCollection(SiteMapNode)

Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse und fügt der SiteMapNode-Eigenschaft das InnerList-Objekt für die Auflistung hinzu.Initializes a new instance of the SiteMapNodeCollection class and adds the SiteMapNode object to the InnerList property for the collection.

SiteMapNodeCollection(SiteMapNode[])

Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse und fügt der SiteMapNode-Eigenschaft das Array vom Typ InnerList für die Auflistung hinzu.Initializes a new instance of the SiteMapNodeCollection class and adds the array of type SiteMapNode to the InnerList property for the collection.

SiteMapNodeCollection(SiteMapNodeCollection)

Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse und fügt der SiteMapNodeCollection-Eigenschaft alle Listenelemente der angegebenen InnerList-Auflistung hinzu.Initializes a new instance of the SiteMapNodeCollection class and adds all the list items of the specified SiteMapNodeCollection collection to the InnerList property for the collection.

SiteMapNodeCollection()

Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse, bei der es sich um die Standardinstanz handelt.Initializes a new instance of the SiteMapNodeCollection class, which is the default instance.

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der SiteMapNodeCollection -Konstruktor verwendet wird, um eine neue Auflistung zu erstellen SiteMapNodeCollection . Anschließend werden der mit der-Methode Elemente hinzugefügt SiteMapNodeCollection Add .The following code example demonstrates how to use the SiteMapNodeCollection constructor to create a new SiteMapNodeCollection collection, and then add elements to the SiteMapNodeCollection with the Add method.

// 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 Auflistung zu erstellen SiteMapNodeCollection .Use the SiteMapNodeCollection constructor to create an empty SiteMapNodeCollection collection. Sie können der SiteMapNodeCollection mithilfe der Add Methode, oder Elemente hinzufügen AddRange Insert .You can add elements to the SiteMapNodeCollection using the Add, AddRange, or Insert method.

Weitere Informationen

Gilt für:

SiteMapNodeCollection(Int32)

Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse mit der angegebenen anfänglichen Kapazität.Initializes a new instance of the SiteMapNodeCollection class with the specified initial capacity.

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.The initial capacity of the SiteMapNodeCollection.

Hinweise

Verwenden Sie den- SiteMapNodeCollection Konstruktor, um eine SiteMapNodeCollection Sammlung mit der angegebenen Anfangskapazität zu erstellen.Use the SiteMapNodeCollection constructor to create a SiteMapNodeCollection collection with the specified initial capacity.

Weitere Informationen

Gilt für:

SiteMapNodeCollection(SiteMapNode)

Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse und fügt der SiteMapNode-Eigenschaft das InnerList-Objekt für die Auflistung hinzu.Initializes a new instance of the SiteMapNodeCollection class and adds the SiteMapNode object to the InnerList property for the collection.

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

Ein SiteMapNode, das zu SiteMapNodeCollection hinzugefügt werden soll.A SiteMapNode to add to the SiteMapNodeCollection.

Ausnahmen

value ist null.value is null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Auflistung SiteMapNodeCollection mit einem einzelnen anfangs SiteMapNode Objekt erstellt und anschließend SiteMapNodeCollection mithilfe der-Methode eine von-Objekten hinzugefügt wird SiteMapNode AddRange .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 das ändern SiteMapNodeCollection , auch wenn die einzelnen Objekte schreibgeschützt sind SiteMapNode .You can modify the SiteMapNodeCollection, even though the individual SiteMapNode objects might be read-only.


// 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 Auflistung SiteMapNodeCollection mit einem einzelnen anfangs Objekt zu erstellen SiteMapNode .Use the SiteMapNodeCollection constructor to create a SiteMapNodeCollection collection with a single initial SiteMapNode object. Sie können der SiteMapNodeCollection mithilfe der Add Methode, oder Elemente hinzufügen AddRange Insert .You can add elements to the SiteMapNodeCollection using the Add, AddRange, or Insert method.

Weitere Informationen

Gilt für:

SiteMapNodeCollection(SiteMapNode[])

Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse und fügt der SiteMapNode-Eigenschaft das Array vom Typ InnerList für die Auflistung hinzu.Initializes a new instance of the SiteMapNodeCollection class and adds the array of type SiteMapNode to the InnerList property for the collection.

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 der SiteMapNodeCollection hinzugefügt werden soll.An array of type SiteMapNode to add to the SiteMapNodeCollection.

Ausnahmen

value ist null.value is null.

Hinweise

Die Verwendung des- SiteMapNodeCollection Konstruktors entspricht dem Aufrufen des SiteMapNodeCollection -Konstruktors und dem Hinzufügen von Elementen zur-Auflistung SiteMapNodeCollection mit der- AddRange Methode.Using the SiteMapNodeCollection constructor is equivalent to calling the SiteMapNodeCollection constructor and adding elements to the SiteMapNodeCollection collection with the AddRange method.

Weitere Informationen

Gilt für:

SiteMapNodeCollection(SiteMapNodeCollection)

Initialisiert eine neue Instanz der SiteMapNodeCollection-Klasse und fügt der SiteMapNodeCollection-Eigenschaft alle Listenelemente der angegebenen InnerList-Auflistung hinzu.Initializes a new instance of the SiteMapNodeCollection class and adds all the list items of the specified SiteMapNodeCollection collection to the InnerList property for the collection.

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

Eine SiteMapNodeCollection, die den SiteMapNode enthält, der der aktuellen SiteMapNodeCollection hinzugefügt werden soll.A SiteMapNodeCollection that contains the SiteMapNode to add to the current SiteMapNodeCollection.

Ausnahmen

value ist null.value is null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Auflistung SiteMapNodeCollection mit einem anderen SiteMapNodeCollection von- SiteMapNode Objekten als Basis erstellt wird.The following code example demonstrates how to create a SiteMapNodeCollection collection using another SiteMapNodeCollection of SiteMapNode objects as a base. Die- SiteMapNode.GetAllNodes Methode gibt einen schreibgeschützten Wert zurück SiteMapNodeCollection , der erkannt wird, wenn die- IsReadOnly Eigenschaft zurückgibt true .The SiteMapNode.GetAllNodes method returns a read-only SiteMapNodeCollection, which is detected when the IsReadOnly property returns true. Ein neues SiteMapNodeCollection wird mit dem schreibgeschützten erstellt, SiteMapNodeCollection und die Add -Methode und die- Remove Methode können erfolgreich aufgerufen werden.A new SiteMapNodeCollection is created using the read-only SiteMapNodeCollection and the Add and Remove methods can be called successfully.

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- SiteMapNodeCollection Konstruktors entspricht dem Aufrufen des SiteMapNodeCollection -Konstruktors und dem Hinzufügen von Elementen zur-Auflistung SiteMapNodeCollection mit der- AddRange Methode.Using the SiteMapNodeCollection constructor is equivalent to calling the SiteMapNodeCollection constructor and adding elements to the SiteMapNodeCollection collection with the AddRange method.

Gilt für: