MenuItemCollection.CopyTo Methode

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

CopyTo(Array, Int32)

Ausnahmen

ArgumentException

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.Array MenuItemCollection , 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

MenuItemCollection.CopyTo Methode

Definition

Überlädt

CopyTo(Array, Int32)

Parameter

Implementiert

Ausnahmen

Hinweise

Siehe auch

Gilt für

CopyTo(MenuItem[], Int32)

Parameter

Beispiele

Hinweise

Siehe auch

Gilt für

Zusätzliche Ressourcen