Freigeben über


MenuItemCollection.CopyTo Methode

Definition

Gibt den Inhalt des aktuellen MenuItemCollection-Objekts zurück.

Überlädt

CopyTo(Array, Int32)

Kopiert alle Elemente aus dem MenuItemCollection-Objekt in ein kompatibles eindimensionales Array, wobei bei dem angegebenen Index des Zielarrays begonnen wird.

CopyTo(MenuItem[], Int32)

Kopiert alle Elemente aus dem MenuItemCollection-Objekt in ein kompatibles eindimensionales Array von MenuItem-Objekten, wobei am angegebenen Index des Zielarrays begonnen wird.

CopyTo(Array, Int32)

Kopiert alle Elemente aus dem MenuItemCollection-Objekt in ein kompatibles eindimensionales Array, wobei bei dem angegebenen Index des Zielarrays begonnen wird.

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)

Parameter

array
Array

Ein nullbasiertes Array, in das Elemente aus der aktuellen MenuItemCollection kopiert werden.

index
Int32

Die Position im Zielarray, bei der mit dem Empfang des kopierten Inhalts begonnen werden soll.

Implementiert

Ausnahmen

array ist kein Array von MenuItem-Objekten.

Hinweise

Verwenden Sie die CopyTo Methode, um den Inhalt des aktuellen MenuItemCollection Objekts in das angegebene Null-basierte System.ArrayObjekt zu kopieren. Elemente werden ab dem angegebenen Index des Zielarrays kopiert. Mit dem System.ArrayMenuItemCollection , können Sie dann die Arraysyntax verwenden, um auf die Elemente im Objekt zuzugreifen.

Alternativ können Sie auch die Methode verwenden, um eine Aufzählung zu erstellen, mit der GetEnumerator auf die Elemente in der Auflistung zugegriffen werden kann.

Siehe auch

Gilt für

CopyTo(MenuItem[], Int32)

Kopiert alle Elemente aus dem MenuItemCollection-Objekt in ein kompatibles eindimensionales Array von MenuItem-Objekten, wobei am angegebenen Index des Zielarrays begonnen wird.

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)

Parameter

array
MenuItem[]

Ein nullbasiertes Array von MenuItem-Objekten, das die kopierten Elemente aus der aktuellen MenuItemCollection empfängt.

index
Int32

Die Position im Zielarray, bei der mit dem Empfang des kopierten Inhalts begonnen werden soll.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Methode verwendet wird, um die CopyTo Elemente in einem Objekt in ein MenuItemCollection Array von MenuItem Objekten zu kopieren.


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

Hinweise

Verwenden Sie die CopyTo Methode, um den Inhalt des aktuellen MenuItemCollection Objekts in das angegebene nullbasierte Array zu kopieren. Elemente werden ab dem angegebenen Index des Zielarrays kopiert. Mit dem MenuItemCollection Array können Sie dann die Arraysyntax verwenden, um auf die Elemente im Objekt zuzugreifen.

Alternativ können Sie auch die Methode verwenden, um eine Aufzählung zu erstellen, mit der GetEnumerator auf die Elemente in der Auflistung zugegriffen werden kann.

Siehe auch

Gilt für