MenuItemCollection.CopyTo Methode

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.

Kopiert den Inhalt des aktuellen MenuItemCollection Objekts.

Überlädt

Name	Beschreibung
CopyTo(Array, Int32)	Kopiert alle Elemente aus dem MenuItemCollection Objekt in einen kompatiblen eindimensionalen Array, beginnend am angegebenen Index im Zielarray.
CopyTo(MenuItem[], Int32)	Kopiert alle Elemente aus dem MenuItemCollection Objekt in ein kompatibles eindimensionales Array von MenuItem Objekten, beginnend am angegebenen Index im Zielarray.

CopyTo(Array, Int32)

Kopiert alle Elemente aus dem MenuItemCollection Objekt in einen kompatiblen eindimensionalen Array, beginnend am angegebenen Index im Zielarray.

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

Eine nullbasierte Array , die die kopierten Elemente aus der aktuellen MenuItemCollection.

index: Int32

Die Position im Zielarray, an der der Empfang des kopierten Inhalts beginnen 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 den angegebenen Null-basierten System.Arrayzu kopieren. Elemente werden beginnend mit dem angegebenen Index des Zielarrays kopiert. Mit dem System.Array, können Sie dann die Arraysyntax verwenden, um auf die Elemente im MenuItemCollection Objekt zuzugreifen.

Alternativ können Sie auch die GetEnumerator Methode verwenden, um einen Enumerator zu erstellen, der für den Zugriff auf die Elemente in der Auflistung verwendet werden kann.

Weitere Informationen

Gilt für:

CopyTo(MenuItem[], Int32)

Kopiert alle Elemente aus dem MenuItemCollection Objekt in ein kompatibles eindimensionales Array von MenuItem Objekten, beginnend am angegebenen Index im Zielarray.

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 dem aktuellen MenuItemCollectionObjekt empfängt.

index: Int32

Die Position im Zielarray, an der der Empfang des kopierten Inhalts beginnen soll.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Methode zum Kopieren der CopyTo Elemente in einem MenuItemCollection Objekt in ein Array von MenuItem Objekten verwendet wird.


<%@ 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 beginnend mit dem angegebenen Index des Zielarrays kopiert. Mit dem Array können Sie dann mithilfe der Arraysyntax auf die Elemente im MenuItemCollection Objekt zugreifen.

Alternativ können Sie auch die GetEnumerator Methode verwenden, um einen Enumerator zu erstellen, der für den Zugriff auf die Elemente in der Auflistung verwendet werden kann.

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?