Sintassi delle espressioni di associazione dati

  • Articolo

Aggiornamento: novembre 2007

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 la classe Cenni preliminari sul controllo server Web XmlDataSource.

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

Concetti

Cenni preliminari sulle espressioni di associazione dati

Introduzione alle pagine Web ASP.NET

Cenni preliminari sulla sintassi delle pagine Web ASP.NET

Cenni preliminari sul controllo server Web XmlDataSource

Riferimenti

XPathBinder