Partilhar via


MenuItemCollection.CopyTo Método

Definição

Copia o conteúdo do objeto MenuItemCollection atual.

Sobrecargas

CopyTo(Array, Int32)

Copia todos os itens do objeto MenuItemCollection para uma matriz unidimensional Arraycompatível, começando no índice especificado na matriz de destino.

CopyTo(MenuItem[], Int32)

Copia todos os itens do objeto MenuItemCollection para uma matriz unidimensional compatível de objetos MenuItem, começando no índice especificado na matriz de destino.

CopyTo(Array, Int32)

Copia todos os itens do objeto MenuItemCollection para uma matriz unidimensional Arraycompatível, começando no índice especificado na 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

Um Array de base zero que recebe os itens copiados do MenuItemCollection atual.

index
Int32

A posição na matriz de destino na qual começar a receber o conteúdo copiado.

Implementações

Exceções

array não é uma matriz de objetos MenuItem.

Comentários

Use o CopyTo método para copiar o conteúdo do objeto atual MenuItemCollection para o baseado em System.Arrayzero especificado. Os itens são copiados a partir do índice especificado da matriz de destino. Com o System.Array, você pode usar a sintaxe da matriz para acessar os itens no MenuItemCollection objeto.

Como alternativa, você também pode usar o GetEnumerator método para criar um enumerador que pode ser usado para acessar os itens na coleção.

Confira também

Aplica-se a

CopyTo(MenuItem[], Int32)

Copia todos os itens do objeto MenuItemCollection para uma matriz unidimensional compatível de objetos MenuItem, começando no índice especificado na 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[]

Uma matriz de base zero de objetos MenuItem que recebe os itens copiados do MenuItemCollection atual.

index
Int32

A posição na matriz de destino na qual começar a receber o conteúdo copiado.

Exemplos

O exemplo de código a seguir demonstra como usar o CopyTo método para copiar os itens em um MenuItemCollection objeto para uma 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>

Comentários

Use o CopyTo método para copiar o conteúdo do objeto atual MenuItemCollection para a matriz baseada em zero especificada. Os itens são copiados a partir do índice especificado da matriz de destino. Com a matriz, você pode usar a sintaxe da matriz para acessar os itens no MenuItemCollection objeto.

Como alternativa, você também pode usar o GetEnumerator método para criar um enumerador que pode ser usado para acessar os itens na coleção.

Confira também

Aplica-se a