SiteMapNodeCollection Constructores

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

Inicializa una nueva instancia de la clase SiteMapNodeCollection.

Sobrecargas

SiteMapNodeCollection()	Inicializa una nueva instancia de la clase SiteMapNodeCollection, que es la predeterminada.
SiteMapNodeCollection(Int32)	Inicializa una nueva instancia de la clase SiteMapNodeCollection con la capacidad inicial especificada.
SiteMapNodeCollection(SiteMapNode)	Inicializa una nueva instancia de la clase SiteMapNodeCollection y agrega el objeto SiteMapNode a la propiedad InnerList de la colección.
SiteMapNodeCollection(SiteMapNode[])	Inicializa una nueva instancia de la clase SiteMapNodeCollection y agrega la matriz de tipo SiteMapNode a la propiedad InnerList de la colección.
SiteMapNodeCollection(SiteMapNodeCollection)	Inicializa una nueva instancia de la clase SiteMapNodeCollection y agrega todos los elementos de lista de la colección SiteMapNodeCollection especificada a la propiedad InnerList de la colección.

SiteMapNodeCollection()

Inicializa una nueva instancia de la clase SiteMapNodeCollection, que es la predeterminada.

public:
 SiteMapNodeCollection();

public SiteMapNodeCollection ();

Public Sub New ()

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el SiteMapNodeCollection constructor para crear una nueva SiteMapNodeCollection colección y, a continuación, agregar elementos al SiteMapNodeCollection con el Add método .

// 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

Comentarios

Use el SiteMapNodeCollection constructor para crear una colección vacía SiteMapNodeCollection . Puede agregar elementos a SiteMapNodeCollection mediante el Addmétodo , AddRangeo Insert .

Consulte también

• SiteMapNodeCollection(SiteMapNode)

SiteMapNodeCollection(Int32)

Inicializa una nueva instancia de la clase SiteMapNodeCollection con la capacidad inicial especificada.

public:
 SiteMapNodeCollection(int capacity);

public SiteMapNodeCollection (int capacity);

new System.Web.SiteMapNodeCollection : int -> System.Web.SiteMapNodeCollection

Public Sub New (capacity As Integer)

Parámetros

capacity

Int32

Capacidad inicial de SiteMapNodeCollection.

Comentarios

Use el SiteMapNodeCollection constructor para crear una SiteMapNodeCollection colección con la capacidad inicial especificada.

Consulte también

• Capacity

SiteMapNodeCollection(SiteMapNode)

Inicializa una nueva instancia de la clase SiteMapNodeCollection y agrega el objeto SiteMapNode a la propiedad InnerList de la colección.

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)

Parámetros

value

SiteMapNode

SiteMapNode que se va a agregar a la SiteMapNodeCollection.

Excepciones

ArgumentNullException

value es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una SiteMapNodeCollection colección con un único objeto inicial SiteMapNode y, a continuación, agregarle un SiteMapNodeCollection de SiteMapNode objetos mediante el AddRange método . Puede modificar , SiteMapNodeCollectionaunque los objetos individuales SiteMapNode puedan ser de solo lectura.

// 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

Comentarios

Use el SiteMapNodeCollection constructor para crear una SiteMapNodeCollection colección con un único objeto inicial SiteMapNode . Puede agregar elementos a SiteMapNodeCollection mediante el Addmétodo , AddRangeo Insert .

Consulte también

• SiteMapNode

SiteMapNodeCollection(SiteMapNode[])

Inicializa una nueva instancia de la clase SiteMapNodeCollection y agrega la matriz de tipo SiteMapNode a la propiedad InnerList de la colección.

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())

Parámetros

value

SiteMapNode[]

Matriz de tipo SiteMapNode que se va a agregar a SiteMapNodeCollection.

Excepciones

ArgumentNullException

value es null.

Comentarios

El uso del SiteMapNodeCollection constructor equivale a llamar al SiteMapNodeCollection constructor y agregar elementos a la SiteMapNodeCollection colección con el AddRange método .

Consulte también

• SiteMapNode

SiteMapNodeCollection(SiteMapNodeCollection)

Inicializa una nueva instancia de la clase SiteMapNodeCollection y agrega todos los elementos de lista de la colección SiteMapNodeCollection especificada a la propiedad InnerList de la colección.

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)

Parámetros

value

SiteMapNodeCollection

SiteMapNodeCollection que contiene el SiteMapNode que se va a agregar a la SiteMapNodeCollection actual.

Excepciones

ArgumentNullException

value es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una SiteMapNodeCollection colección con otro SiteMapNodeCollection de SiteMapNode objetos como base. El SiteMapNode.GetAllNodes método devuelve un valor de solo SiteMapNodeCollectionlectura , que se detecta cuando la IsReadOnly propiedad devuelve true. Se crea un nuevo SiteMapNodeCollection mediante el solo SiteMapNodeCollection lectura y se puede llamar correctamente a los Add métodos y Remove .

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

El uso del SiteMapNodeCollection constructor equivale a llamar al SiteMapNodeCollection constructor y agregar elementos a la SiteMapNodeCollection colección con el AddRange método .