Syntax für Datenbindungsausdrücke

Artikel
05/27/2012

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

Datenbindungsausdrücke stellen beim Aufruf der DataBind-Methode eine Bindung zwischen einer Eigenschaft eines Serversteuerelements und einer Datenquelle her. Sie können Datenbindungsausdrücke auf der Wertseite eines Attribut-Wert-Paars im Starttag eines Serversteuerelements oder an einer beliebigen anderen Stelle der Seite einfügen.

<tagprefix:tagname property="<%# data-binding expression %>"
   runat="server" />
- or -
literal text <%# data-binding expression %>

Parameter

property
Die Eigenschaft des Steuerelements, für die die Datenbindung deklariert wird.
Datenbindungsausdruck
Ein beliebiger Ausdruck, der den im Abschnitt Hinweise angegebenen Anforderungen entspricht.

Hinweise

Alle Datenbindungsausdrücke müssen in die Zeichenfolgen <%# und %> eingeschlossen werden.

ASP.NET unterstützt ein hierarchisches Datenbindungsmodell, das Bindungen zwischen Eigenschaften von Serversteuerelementen und Datenquellen unterstützt. Nahezu jede Eigenschaft eines Serversteuerelements kann an ein öffentliches Feld oder eine Eigenschaft auf der entsprechenden Seite oder im direkten Namenscontainer des Serversteuerelements gebunden werden.

Datenbindungsausdrücke verwenden die Eval-Methode und die Bind-Methode, um Daten an Steuerelemente zu binden und Änderungen an die Datenbank zu übertragen. Die Eval-Methode ist eine statische Methode (schreibgeschützt), die den Wert eines Datenfelds entgegennimmt und als Zeichenfolge zurückgibt. Die Bind-Methode stellt Funktionen für den Lese- und Schreibzugriff bereit, die dem Auslesen der Werte datengebundener Steuerelemente sowie der Rückübertragung vorgenommener Änderungen an die Datenbank dienen.

Die Bindung an XML-Daten aus einem XmlDataSource-Steuerelement kann sowohl mithilfe der XPath-Methode und der XPathSelect-Methode als auch mit der XPathBinder-Klasse erfolgen. Weitere Informationen hierzu finden Sie unter XmlDataSource Web Server Control Overview.

Beispiel

Das folgende Codebeispiel veranschaulicht die Datenbindung an Eigenschaften in einem ASP.NET-Serversteuerelement. Wenn ein Benutzer einen Zustand aus dem DropDownList-Webserversteuerelement auswählt, wird das Label-Webserversteuerelement an das ausgewählte Listenelement gebunden, und der ausgewählte Zustand wird angezeigt.

<html>
<head>
    <script language="C#" runat="server">
        void SubmitBtn_Click(Object sender, EventArgs e) {
          // Rather than explictly pulling out the variable from the StateList control
          // and then manipulating a Label control, just call Page.DataBind.
          // This will evaluate any <%# %> expressions within the page.   
          Page.DataBind();
        }
    </script>
</head>
<body>

    <h3><font face="Verdana">Binding to a property of another server control</font></h3>
    <form runat="server">
        <asp:DropDownList id="StateList" runat="server">
          <asp:ListItem>CA</asp:ListItem>
          <asp:ListItem>IN</asp:ListItem>
          <asp:ListItem>KS</asp:ListItem>
          <asp:ListItem>MD</asp:ListItem>
          <asp:ListItem>MI</asp:ListItem>
          <asp:ListItem>OR</asp:ListItem>
          <asp:ListItem>TN</asp:ListItem>
          <asp:ListItem>UT</asp:ListItem>
        </asp:DropDownList>       
        <asp:button Text="Submit" OnClick="SubmitBtn_Click" runat="server"/>        
        <p>     
        Selected State: <asp:label text='<%# StateList.SelectedItem.Text %>' runat="server"/>     
    </form>
</body>
</html>

<html>
<head>
    <script language="VB" runat="server">
         Sub SubmitBtn_Click(sender As Object, e As EventArgs)
            ' Rather than explictly pulling out the variable from the StateList control
            ' and then manipulating a Label control, just call Page.DataBind.
            ' This will evaluate any <%# %> expressions within the page.   
            Page.DataBind()
         End Sub
    </script>
</head>
<body>

    <h3><font face="Verdana"> Binding to a property of another server control</font></h3>
    <form runat="server">
        <asp:DropDownList id="StateList" runat="server">
          <asp:ListItem>CA</asp:ListItem>
          <asp:ListItem>IN</asp:ListItem>
          <asp:ListItem>KS</asp:ListItem>
          <asp:ListItem>MD</asp:ListItem>
          <asp:ListItem>MI</asp:ListItem>
          <asp:ListItem>OR</asp:ListItem>
          <asp:ListItem>TN</asp:ListItem>
          <asp:ListItem>UT</asp:ListItem>
        </asp:DropDownList>       
        <asp:button Text="Submit" OnClick="SubmitBtn_Click" runat="server"/>        
        <p>     
        Selected State: <asp:label text='<%# StateList.SelectedItem.Text %>' runat="server"/>     
    </form>
</body>
</html>