Menu.DataBindings Eigenschaft

Definition

Ruft eine Auflistung von MenuItemBinding-Objekten ab, die die Beziehung zwischen einem Datenelement und dem Menüelement, an das es gebunden werden soll, definieren.Gets a collection of MenuItemBinding objects that define the relationship between a data item and the menu item it is binding to.

public:
 property System::Web::UI::WebControls::MenuItemBindingCollection ^ DataBindings { System::Web::UI::WebControls::MenuItemBindingCollection ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.MenuItemBindingCollection DataBindings { get; }
member this.DataBindings : System.Web.UI.WebControls.MenuItemBindingCollection
Public ReadOnly Property DataBindings As MenuItemBindingCollection

Eigenschaftswert

Eine MenuItemBindingCollection, die die Beziehung zwischen einem Datenelement und dem Menüelement, an das es gebunden werden soll, darstellt.A MenuItemBindingCollection that represents the relationship between a data item and the menu item it is binding to.

Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die DataBindings -Auflistung verwendet wird, um die Beziehung zwischen den XmlDataSource Feldern eines-Steuer Elements und den Menu Menü Elementen in einem-Steuerelement zu definieren.The following code example demonstrates how to use the DataBindings collection to define the relationship between the fields of an XmlDataSource control and the menu items in a Menu control. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die folgenden XML-Beispiel Daten in eine Datei mit dem Namen "map. xml" kopieren.For this example to work correctly, you must copy the sample XML data below to a file named Map.xml.


<%@ 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>


<%@ Page Language="VB" %>

<!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>

Im folgenden finden Sie Beispiele für Site Übersichts Daten für das vorherige Beispiel.The following is sample site map data for the previous example.

<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

Die DataBindings -Auflistung MenuItemBinding enthält-Objekte, die die Beziehung zwischen einem Datenelement und dem Menü Element definieren, an das es gebunden wird.The DataBindings collection contains MenuItemBinding objects that define the relationship between a data item and the menu item it is binding to. Beim Binden an eine Datenquelle, in der jedes Datenelement mehrere Eigenschaften enthält (z. b. ein XML-Element mit mehreren Attributen), zeigt ein Menü Element ToString() den von der-Methode des Datenelements zurückgegebenen Wert standardmäßig an.When binding to a data source where each data item contains multiple properties (such as an XML element with several attributes), a menu item displays the value returned by the ToString() method of the data item by default. Im Fall eines XML-Elements zeigt das Menü Element den Elementnamen an, der die zugrunde liegende Struktur der Struktur anzeigt, aber andernfalls nicht sehr nützlich ist.In the case of an XML element, the menu item displays the element name, which shows the underlying structure of the tree, but is not very useful otherwise. Sie können ein Menü Element an eine bestimmte Datenelement Eigenschaft binden, indem Sie Menü Element Bindungen angeben.You can bind a menu item to a specific data item property by specifying menu item bindings.

Beim Definieren der Beziehung zwischen einem Datenelement und einem Menü Element müssen Sie sowohl die Kriterien für die Bindung als auch die-Eigenschaft eines Datenelements angeben, an das die Bindung erfolgen soll.When defining the relationship between a data item and a menu item, you must specify both the criteria for binding and the property of a data item to bind to. Die Kriterien geben an, wann ein Datenelement an ein Menü Element gebunden werden soll.The criteria indicate when a data item should be bound to a menu item. Die Kriterien können mit einer Tiefe, einem Datenmember oder beidem angegeben werden.The criteria can be specified with a depth, a data member, or both. Die Tiefe gibt die Menü Ebene an, die gebunden wird.The depth specifies the menu level that gets bound. Wenn Sie z. b. eine Tiefe von 0 angeben, werden alle Menü Elemente in der Baumstruktur auf Ebene 0 mithilfe der Menü Element Bindung gebunden.For example, if you specify a depth of 0, all menu items in the tree structure at level 0 are bound using the menu item binding. Ein Datenmember gibt den Typ des Datenelements in der zugrunde liegenden Datenquelle an, kann jedoch unterschiedliche Informationen darstellen, abhängig von der Datenquelle.A data member specifies the type of the data item in the underlying data source, but can represent different information depending on the data source. Der-Datenmember für ein XML-Element gibt z. b. den Namen des Elements an.For example, the data member for an XML element specifies the name of the element.

Wenn mehrere MenuItemBinding Objekte definiert sind, die miteinander in Konflikt stehen, Menu wendet das Steuerelement die Menü Element Bindungen in der folgenden Rangfolge an:If multiple MenuItemBinding objects are defined that conflict with each other, the Menu control applies the menu item bindings in the following order of precedence:

  1. Das MenuItemBinding -Objekt, das eine Tiefe und einen Datenmember definiert.The MenuItemBinding object that defines both a depth and a data member.

  2. Das MenuItemBinding -Objekt, das nur die Tiefe definiert.The MenuItemBinding object that defines only the depth.

  3. Das MenuItemBinding -Objekt, das nur den Datenmember definiert.The MenuItemBinding object that defines only the data member.

  4. Das MenuItemBinding -Objekt, das weder die Tiefe noch den Datenmember definiert.The MenuItemBinding object that defines neither the depth nor the data member.

Nachdem Sie die Bindungs Kriterien festgelegt haben, können Sie eine Eigenschaft eines MenuItem -Objekts binden, die an ein Attribut oder Feld eines Datenelements gebunden werden kann.Once the binding criteria are established, you can then bind a property of a MenuItem object that is able to be bound to an attribute or field of a data item. Beispielsweise können Sie die Text -Eigenschaft eines Menü Elements an das Text-Attribut eines XML-Elements binden, indem Sie die TextField -Eigenschaft MenuItemBinding eines-Objekts festlegen.For example, you can bind the Text property of a menu item to the text attribute on an XML element by setting the TextField property of a MenuItemBinding object. Sie können auch eine Bindung an einen statischen Wert durch herstellen.You can also bind to a static value. Wenn Sie die Text -Eigenschaft MenuItemBinding eines-Objekts festlegen, haben alle Menü Elemente, MenuItemBinding auf die das-Objekt angewendet wird, denselben statischen Textwert.If you set the Text property of a MenuItemBinding object, all menu items to which the MenuItemBinding object is applied share the same static text value. Weitere Informationen zum Binden der Eigenschaften eines MenuItem -Objekts an einen-Wert finden MenuItemBindingSie unter.For more information on binding the properties of a MenuItem object to a value, see MenuItemBinding.

Obwohl die DataBindings Auflistung Programm gesteuert aufgefüllt werden kann, wird Sie normalerweise deklarativ festgelegt.Although the DataBindings collection can be programmatically populated, it is usually set declaratively. Um die Menü Element Bindungen anzugeben, Schachteln Sie zuerst öffnende <DataBindings> und schließende Tags zwischen dem öffnenden und Menu dem schließenden Tag des Steuer Elements.To specify the menu item bindings, first nest opening and closing <DataBindings> tags between the opening and closing tags of the Menu control. Platzieren <asp:MenuItemBinding> Sie als nächstes Elemente zwischen den öffnenden <DataBindings> und schließenden Tags für jede Menü Element Bindung, die Sie angeben möchten.Next, place <asp:MenuItemBinding> elements between the opening and closing <DataBindings> tags for each menu item binding you want to specify.

Gilt für:

Siehe auch