MenuItemBindingCollection.CopyTo(MenuItemBinding[], Int32) 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.
Kopiert alle Elemente aus dem MenuItemBindingCollection Objekt in ein kompatibles eindimensionales Array von MenuItemBinding Objekten, beginnend am angegebenen Index im Zielarray.
public:
void CopyTo(cli::array <System::Web::UI::WebControls::MenuItemBinding ^> ^ array, int index);public void CopyTo(System.Web.UI.WebControls.MenuItemBinding[] array, int index);override this.CopyTo : System.Web.UI.WebControls.MenuItemBinding[] * int -> unitPublic Sub CopyTo (array As MenuItemBinding(), index As Integer)Parameter
- array
- MenuItemBinding[]
Ein nullbasiertes Array von MenuItemBinding Objekten, das die kopierten Elemente aus der Auflistung 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 CopyTo Methode verwendet wird, um die MenuItemBinding Objekte aus der Auflistung in ein Array zu kopieren. Anschließend wird das Array durchlaufen, um die Eigenschaften der MenuItemBinding Objekte anzuzeigen. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die folgenden XML-Beispieldaten in eine Datei mit dem Namen Map.xmlkopieren.
<%@ 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)
{
// Declare an array of MenuItemBinding objects.
MenuItemBinding[] bindingArray = new MenuItemBinding[NavigationMenu.DataBindings.Count];
// Use the CopyTo method to copy the MenuItemBinding objects
// from the collection into the array.
NavigationMenu.DataBindings.CopyTo(bindingArray, 0);
// Display the properties of the MenuItemBinding objects
// in the Bindings collection.
Message.Text = "The properties of the MenuItemBinding objects are: <br/><br/>";
foreach (MenuItemBinding binding in bindingArray)
{
Message.Text += "DataMember=" + binding.TextField +
" Depth=" + binding.Depth.ToString() + "<br />";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItemBindingCollection CopyTo Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemBindingCollection CopyTo Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
target="_blank"
datasourceid="MenuSource"
runat="server">
<DataBindings>
<asp:menuitembinding datamember="MapHomeNode"
depth="0"
textfield="title"
navigateurlfield="url"/>
<asp:menuitembinding datamember="MapNode"
depth="1"
textfield="title"
navigateurlfield="url"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
textfield="title"
navigateurlfield="url"/>
</DataBindings>
</asp:menu>
<hr/>
<asp:label id="Message"
runat="server"/>
<asp:xmldatasource id="MenuSource"
datafile="Map.xml"
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)
' Declare an array of MenuItemBinding objects.
Dim bindingArray(NavigationMenu.DataBindings.Count - 1) As MenuItemBinding
' Use the CopyTo method to copy the MenuItemBinding objects
' from the collection into the array.
NavigationMenu.DataBindings.CopyTo(bindingArray, 0)
' Display the properties of the MenuItemBinding objects
' in the Bindings collection.
Message.Text = "The properties of the MenuItemBinding objects are: <br/><br/>"
Dim binding As MenuItemBinding
For Each binding In bindingArray
Message.Text &= "DataMember=" & binding.TextField & _
" Depth=" & binding.Depth.ToString() & "<br />"
Next
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MenuItemBindingCollection CopyTo Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemBindingCollection CopyTo Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
target="_blank"
datasourceid="MenuSource"
runat="server">
<DataBindings>
<asp:menuitembinding datamember="MapHomeNode"
depth="0"
textfield="title"
navigateurlfield="url"/>
<asp:menuitembinding datamember="MapNode"
depth="1"
textfield="title"
navigateurlfield="url"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
textfield="title"
navigateurlfield="url"/>
</DataBindings>
</asp:menu>
<hr/>
<asp:label id="Message"
runat="server"/>
<asp:xmldatasource id="MenuSource"
datafile="Map.xml"
runat="server"/>
</form>
</body>
</html>
Im Folgenden sind Beispiel-Siteübersichtsdaten für das vorherige Beispiel dargestellt.
<MapHomeNode url="~\Home.aspx"
title="Home"
description="Home">
<MapNode url="~\Music.aspx"
title="Music"
description="Music">
<MapNode url="~\Classical.aspx"
title="Classical"
description="Classical"/>
<MapNode url="~\Rock.aspx"
title="Rock"
description="Rock"/>
<MapNode url="~\Jazz.aspx"
title="Jazz"
description="Jazz"/>
</MapNode>
<MapNode url="~\Movies.aspx"
title="Movies"
description="Movies">
<MapNode url="~\Action.aspx"
title="Action"
description="Action"/>
<MapNode url="~\Drama.aspx"
title="Drama"
description="Drama"/>
<MapNode url="~\Musical.aspx"
title="Musical"
description="Musical"/>
</MapNode>
</MapHomeNode>
Hinweise
Verwenden Sie die CopyTo Methode, um den Inhalt der Auflistung 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 MenuItemBindingCollection 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.
