Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
Menu.DataBindings-Eigenschaft
Ruft eine Auflistung von MenuItemBinding-Objekten ab, die die Beziehung zwischen einem Datenelement und dem Menüelement, an das es gebunden werden soll, definieren.
Assembly: System.Web (in System.Web.dll)
[PersistenceModeAttribute(PersistenceMode.InnerProperty)] public MenuItemBindingCollection DataBindings { get; }
Eigenschaftswert
Typ: System.Web.UI.WebControls.MenuItemBindingCollectionEine MenuItemBindingCollection, die die Beziehung zwischen einem Datenelement und dem Menüelement, an das es gebunden werden soll, darstellt.
Die DataBindings-Auflistung enthält MenuItemBinding-Objekte, die die Beziehung zwischen einem Datenelement und dem Menüelement, an das es gebunden werden soll, definieren. Beim Binden an eine Datenquelle, in der jedes Datenelement mehrere Eigenschaften enthält (so z. B. ein XML-Element mit mehreren Attributen), wird der von der ToString()-Methode des Datenelements zurückgegebene Wert standardmäßig von einem Menüelement angezeigt. Im Falle eines XML-Elements zeigt das Menüelement den Elementnamen an, der zwar die zugrunde liegende Struktur angibt, aber ansonsten wenig Informationen enthält. Sie können ein Menüelement an eine bestimmte Datenelementeigenschaft binden, indem Sie Menüelementbindungen angeben.
Beim Definieren der Beziehung zwischen einem Datenelement und einem Menüelement müssen Sie sowohl die Bindungskriterien als auch die Eigenschaft des Datenelements angeben, an das gebunden werden soll. Die Kriterien geben an, wenn ein Datenelement an ein Menüelement gebunden werden sollte. Die Kriterien können entweder mit einer Tiefe oder einem Datenmember oder mit beiden Werten angegeben werden. Die Tiefe gibt die Menüebene an, die gebunden wird. Wenn Sie beispielsweise eine Tiefe von 0 (null) angeben, werden alle Menüelemente, die sich in der Struktur auf der Ebene 0 (null) befinden, mithilfe der Menüelementbindung gebunden. Ein Datenmember gibt den Typ des Datenelements in der zugrunde liegenden Datenquelle an, kann je nach Datenquelle jedoch auch andere Informationen darstellen. Beispielsweise gibt der Datenmember für ein XML-Element den Namen des Elements an.
Wenn mehrere MenuItemBinding-Objekte definiert werden, die untereinander Konflikte auslösen, werden die Menüelementbindungen vom Menu-Steuerelement in der folgenden Prioritätenreihenfolge angewendet:
-
Das MenuItemBinding-Objekt, das sowohl die Tiefe als auch einen Datenmember definiert.
-
Das MenuItemBinding-Objekt, das nur die Tiefe definiert.
-
Das MenuItemBinding-Objekt, das nur den Datenmember definiert.
-
Das MenuItemBinding-Objekt, das weder die Tiefe noch den Datenmember definiert.
Wenn diese Bindungskriterien etabliert sind, können Sie eine Eigenschaft eines MenuItem-Objekts, das die Fähigkeit zur Bindung besitzt, an ein Attribut oder Feld eines Datenelements binden. So können Sie z. B. die Text-Eigenschaft eines Menüelements an das Textattribut eines XML-Elements binden, indem Sie die TextField-Eigenschaft eines MenuItemBinding-Objekts festlegen. Sie können auch an einen statischen Wert binden. Wenn Sie die Text-Eigenschaft eines MenuItemBinding-Objekts festlegen, wird der gleiche statische Textwert auf alle Menüelemente angewendet, für die dieses MenuItemBinding-Objekt gilt. Weitere Informationen zum Binden der Eigenschaften eines MenuItem-Objekts an einen Wert finden Sie unter MenuItemBinding.
Obwohl die DataBindings-Auflistung programmgesteuert gefüllt werden kann, wird sie normalerweise deklarativ festgelegt. Um Menüelementbindungen anzugeben, müssen zunächst die öffnenden und schließenden <DataBindings>-Tags zwischen den öffnenden und schließenden Tags des Menu-Steuerelements geschachtelt werden. Danach platzieren Sie für jede von Ihnen gewünschte Menüelementbindung die <asp:MenuItemBinding>-Elemente zwischen den öffnenden und schließenden <DataBindings>-Tags.
Im folgenden Codebeispiel wird die Verwendung der DataBindings-Auflistung zum Definieren der Beziehung zwischen den Feldern eines XmlDataSource-Steuerelements und den Menüelementen in einem Menu-Steuerelement veranschaulicht. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie das nachfolgenden Beispiel der XML-Daten in eine Datei mit dem Namen Map.xml kopieren.
<%@ Page Language="C#" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>Menu DataBindings Example</title> </head> <body> <form id="form1" runat="server"> <h3>Menu DataBindings Example</h3> <asp:menu id="NavigationMenu" staticdisplaylevels="1" 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> <asp:XmlDataSource id="MenuSource" datafile="Map.xml" runat="server"/> </form> </body> </html>
Nachfolgend finden Sie ein Beispiel für die Siteübersichtsdaten für das vorherige Beispiel.
<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>
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Möchten Sie an der Umfrage teilnehmen?
