MenuItemBindingCollection.CopyTo(MenuItemBinding[], Int32) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Copia todos los elementos del MenuItemBindingCollection objeto en una matriz unidimensional compatible de MenuItemBinding objetos, empezando por el índice especificado en la matriz de destino.
public:
void CopyTo(cli::array <System::Web::UI::WebControls::MenuItemBinding ^> ^ array, int index);public void CopyTo(System.Web.UI.WebControls.MenuItemBinding[] array, int index);override this.CopyTo : System.Web.UI.WebControls.MenuItemBinding[] * int -> unitPublic Sub CopyTo (array As MenuItemBinding(), index As Integer)Parámetros
- array
- MenuItemBinding[]
Matriz de objetos de base MenuItemBinding cero que recibe los elementos copiados de la colección.
- index
- Int32
Posición de la matriz de destino en la que empezar a recibir el contenido copiado.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar el CopyTo método para copiar los MenuItemBinding objetos de la colección en una matriz. A continuación, la matriz se recorre en iteración para mostrar las propiedades de los MenuItemBinding objetos. Para que este ejemplo funcione correctamente, debe copiar los datos XML de ejemplo siguientes en un archivo denominado Map.xml.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Page_Load(Object sender, EventArgs e)
{
// Declare an array of MenuItemBinding objects.
MenuItemBinding[] bindingArray = new MenuItemBinding[NavigationMenu.DataBindings.Count];
// Use the CopyTo method to copy the MenuItemBinding objects
// from the collection into the array.
NavigationMenu.DataBindings.CopyTo(bindingArray, 0);
// Display the properties of the MenuItemBinding objects
// in the Bindings collection.
Message.Text = "The properties of the MenuItemBinding objects are: <br/><br/>";
foreach (MenuItemBinding binding in bindingArray)
{
Message.Text += "DataMember=" + binding.TextField +
" Depth=" + binding.Depth.ToString() + "<br />";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItemBindingCollection CopyTo Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemBindingCollection CopyTo Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
target="_blank"
datasourceid="MenuSource"
runat="server">
<DataBindings>
<asp:menuitembinding datamember="MapHomeNode"
depth="0"
textfield="title"
navigateurlfield="url"/>
<asp:menuitembinding datamember="MapNode"
depth="1"
textfield="title"
navigateurlfield="url"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
textfield="title"
navigateurlfield="url"/>
</DataBindings>
</asp:menu>
<hr/>
<asp:label id="Message"
runat="server"/>
<asp:xmldatasource id="MenuSource"
datafile="Map.xml"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
' Declare an array of MenuItemBinding objects.
Dim bindingArray(NavigationMenu.DataBindings.Count - 1) As MenuItemBinding
' Use the CopyTo method to copy the MenuItemBinding objects
' from the collection into the array.
NavigationMenu.DataBindings.CopyTo(bindingArray, 0)
' Display the properties of the MenuItemBinding objects
' in the Bindings collection.
Message.Text = "The properties of the MenuItemBinding objects are: <br/><br/>"
Dim binding As MenuItemBinding
For Each binding In bindingArray
Message.Text &= "DataMember=" & binding.TextField & _
" Depth=" & binding.Depth.ToString() & "<br />"
Next
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItemBindingCollection CopyTo Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemBindingCollection CopyTo Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
target="_blank"
datasourceid="MenuSource"
runat="server">
<DataBindings>
<asp:menuitembinding datamember="MapHomeNode"
depth="0"
textfield="title"
navigateurlfield="url"/>
<asp:menuitembinding datamember="MapNode"
depth="1"
textfield="title"
navigateurlfield="url"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
textfield="title"
navigateurlfield="url"/>
</DataBindings>
</asp:menu>
<hr/>
<asp:label id="Message"
runat="server"/>
<asp:xmldatasource id="MenuSource"
datafile="Map.xml"
runat="server"/>
</form>
</body>
</html>
A continuación se incluyen datos de mapa de sitio de ejemplo para el ejemplo anterior.
<MapHomeNode url="~\Home.aspx"
title="Home"
description="Home">
<MapNode url="~\Music.aspx"
title="Music"
description="Music">
<MapNode url="~\Classical.aspx"
title="Classical"
description="Classical"/>
<MapNode url="~\Rock.aspx"
title="Rock"
description="Rock"/>
<MapNode url="~\Jazz.aspx"
title="Jazz"
description="Jazz"/>
</MapNode>
<MapNode url="~\Movies.aspx"
title="Movies"
description="Movies">
<MapNode url="~\Action.aspx"
title="Action"
description="Action"/>
<MapNode url="~\Drama.aspx"
title="Drama"
description="Drama"/>
<MapNode url="~\Musical.aspx"
title="Musical"
description="Musical"/>
</MapNode>
</MapHomeNode>
Comentarios
Use el CopyTo método para copiar el contenido de la colección en la matriz de base cero especificada. Los elementos se copian a partir del índice especificado de la matriz de destino. Con la matriz, puede usar la sintaxis de matriz para acceder a los elementos del MenuItemBindingCollection objeto .
Como alternativa, también puede usar el GetEnumerator método para crear un enumerador que se pueda usar para tener acceso a los elementos de la colección.
