MenuItemCollection.CopyTo Método

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

CopyTo(Array, Int32)

Exceções

ArgumentException

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

MenuItemCollection.CopyTo Método

Definição

Sobrecargas

CopyTo(Array, Int32)

Parâmetros

Implementações

Exceções

Comentários

Confira também

Aplica-se a

CopyTo(MenuItem[], Int32)

Parâmetros

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais