Sintassi delle espressioni di associazione dati

[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]

Le espressioni di associazione dati creano associazioni tra una proprietà dei controlli server e un'origine dati quando viene richiamato il metodo DataBind per la pagina. È possibile includere le espressioni di associazione dati in corrispondenza del valore di una coppia attributo/valore nel tag di apertura di un controllo server oppure in qualsiasi altro punto della pagina.

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

Parametri

  • property
    Proprietà del controllo per il quale viene dichiarata questa associazione dati.

  • Espressione di associazione dati.
    Qualsiasi espressione conforme ai requisiti indicati nella sezione Note che segue.

Note

Tutte le espressioni di associazione dati devono essere contenute tra i caratteri <%# e %>.

In ASP.NET viene supportato un modello di associazione dati gerarchica che crea associazioni tra proprietà di controlli server e origini dati. Qualsiasi proprietà di controllo server può essere associata rispetto a una proprietà o a un campo pubblico nella relativa pagina oppure nel contenitore di denominazione immediatamente successivo del controllo server.

Le espressioni di associazione dati utilizzano i metodi Eval e Bind per associare i dati ai controlli e inviare nuovamente le modifiche al database. Il metodo Eval è un metodo statico di sola lettura che accetta il valore di un campo dati e lo restituisce come stringa. Il metodo Bind supporta la funzionalità di lettura e scrittura con la possibilità di recuperare i valori di controlli associati a dati e di inviare nuovamente al database eventuali modifiche.

È possibile effettuare l'associazione ai dati XML da un controllo XmlDataSource mediante i metodi XPath e XPathSelect, nonché la classe XPathBinder. Per ulteriori informazioni, vedere XmlDataSource Web Server Control Overview.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come associare dati rispetto a proprietà in un controllo server ASP.NET. Quando un utente seleziona uno stato dal controllo server Web DropDownList, il controllo server Web Label viene associato rispetto all'elemento selezionato dall'elenco e viene visualizzato lo stato selezionato.

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

Vedere anche

Riferimenti

XPathBinder

Concetti

Data-Binding Expressions Overview

Introduction to ASP.NET Web Pages

ASP.NET Web Page Syntax Overview

XmlDataSource Web Server Control Overview