MenuItemCollection.CopyTo Methode
Definition
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
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.