MenuItemCollection.CopyTo Método

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

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 el contenido del objeto actual MenuItemCollection .

Sobrecargas

Nombre	Description
CopyTo(Array, Int32)	Copia todos los elementos del MenuItemCollection objeto en una unidimensional Arraycompatible, empezando por el índice especificado en la matriz de destino.
CopyTo(MenuItem[], Int32)	Copia todos los elementos del MenuItemCollection objeto en una matriz unidimensional compatible de MenuItem objetos, empezando por el índice especificado en la matriz de destino.

CopyTo(Array, Int32)

Copia todos los elementos del MenuItemCollection objeto en una unidimensional Arraycompatible, empezando por el índice especificado en la matriz de destino.

public:
 virtual void CopyTo(Array ^ array, int index);

public void CopyTo(Array array, int index);

abstract member CopyTo : Array * int -> unit
override this.CopyTo : Array * int -> unit

Public Sub CopyTo (array As Array, index As Integer)

Parámetros

array: Array

Base cero Array que recibe los elementos copiados del objeto actual MenuItemCollection.

index: Int32

Posición de la matriz de destino en la que empezar a recibir el contenido copiado.

Implementaciones

CopyTo(Array, Int32)

Excepciones

ArgumentException

array no es una matriz de MenuItem objetos.

Comentarios

Use el CopyTo método para copiar el contenido del objeto actual MenuItemCollection en el objeto de base System.Arraycero especificado. Los elementos se copian a partir del índice especificado de la matriz de destino. System.ArrayCon , puede usar la sintaxis de matriz para tener acceso a los elementos del MenuItemCollection 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.

Consulte también

Se aplica a

CopyTo(MenuItem[], Int32)

Copia todos los elementos del MenuItemCollection objeto en una matriz unidimensional compatible de MenuItem objetos, empezando por el índice especificado en la matriz de destino.

public:
 void CopyTo(cli::array <System::Web::UI::WebControls::MenuItem ^> ^ array, int index);

public void CopyTo(System.Web.UI.WebControls.MenuItem[] array, int index);

member this.CopyTo : System.Web.UI.WebControls.MenuItem[] * int -> unit

Public Sub CopyTo (array As MenuItem(), index As Integer)

Parámetros

array: MenuItem[]

Matriz de objetos de base MenuItem cero que recibe los elementos copiados del objeto actual MenuItemCollection.

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 elementos de un MenuItemCollection objeto en una matriz de MenuItem objetos.


<%@ 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)
  {

    // Display the submenu items of the Music
    // menu item. 

    // Retrieve the Music menu item.
    MenuItem musicMenuItem = NavigationMenu.FindItem(@"Home");

    // Declare an array of MenuItem objects.
         MenuItem[] musicItemArray = new MenuItem[musicMenuItem.ChildItems.Count];

    // Use the CopyTo method to copy the submenu items 
    // of the Music menu item into the array.
    musicMenuItem.ChildItems.CopyTo(musicItemArray, 0);
    
    // Display the menu items.
    Message.Text = "The submenu items of the Home menu item are: <br/><br/>";

    foreach (MenuItem item in musicItemArray)
    {

      Message.Text += item.Text + "<br />";

    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemCollection CopyTo Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemCollection CopyTo Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        runat="server">
        
        <items>
          <asp:menuitem text="Home"
            tooltip="Home">
            <asp:menuitem text="Music"
              tooltip="Music">
              <asp:menuitem text="Classical"
                tooltip="Classical"/>
              <asp:menuitem text="Rock"
                tooltip="Rock"/>
              <asp:menuitem text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem text="Movies"
              tooltip="Movies">
              <asp:menuitem text="Action"
                tooltip="Action"/>
              <asp:menuitem text="Drama"
                tooltip="Drama"/>
              <asp:menuitem text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>

      </asp:menu>
      
      <hr/>

      <asp:label id="Message" 
        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)

    ' Display the submenu items of the Music
    ' menu item. 

    ' Retrieve the Music menu item.
    Dim musicMenuItem As MenuItem = NavigationMenu.FindItem("Home")

    ' Declare an array of MenuItem objects.
    Dim musicItemArray(musicMenuItem.ChildItems.Count - 1) As MenuItem
    
    ' Use the CopyTo method to copy the submenu items 
    ' of the Music menu item into the array.
    musicMenuItem.ChildItems.CopyTo(musicItemArray, 0)
    
    ' Display the menu items.
        Message.Text = "The submenu items of the Home menu item are: <br/><br/>"
    
    Dim item As MenuItem
    For Each item In musicItemArray
    
      Message.Text &= item.Text & "<br />"

    Next

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemCollection CopyTo Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemCollection CopyTo Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        runat="server">
        
        <items>
          <asp:menuitem text="Home"
            tooltip="Home">
            <asp:menuitem text="Music"
              tooltip="Music">
              <asp:menuitem text="Classical"
                tooltip="Classical"/>
              <asp:menuitem text="Rock"
                tooltip="Rock"/>
              <asp:menuitem text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem text="Movies"
              tooltip="Movies">
              <asp:menuitem text="Action"
                tooltip="Action"/>
              <asp:menuitem text="Drama"
                tooltip="Drama"/>
              <asp:menuitem text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>

      </asp:menu>
      
      <hr/>

      <asp:label id="Message" 
        runat="server"/>

    </form>
  </body>
</html>

Comentarios

Utilice el CopyTo método para copiar el contenido del objeto actual MenuItemCollection 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 MenuItemCollection 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.

Consulte también

Se aplica a

Comentarios

¿Le ha resultado útil esta página?