Data-Binding Expression Syntax

Artigo
08/04/2011

Expressões de ligação de dados criar ligações entre uma propriedade de controle de servidor e dados de origem quando o DataBind método é chamado na página. Você pode incluir expressões de ligação de dados do lado do valor de um par de valor do atributo na marca de abertura de um controle de servidor ou em qualquer lugar na página.

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

Parâmetros

property
A propriedade do controle para o qual esta associação de dados é declarada.
expressão de ligação de dados
Qualquer expressão que está de acordo com os requisitos descritos na seção comentários.

Comentários

Todas as expressões de ligação de dados devem estar contidas entre < % # e % > caracteres.

ASP.NET oferece suporte a um modelo de ligação de dados hierárquico que cria vinculações entre fontes de dados e propriedades de controle do servidor. Pode ser vinculada a praticamente qualquer propriedade do controle de servidor contra qualquer campo público ou propriedade na página contendo ou no contêiner de nomeação imediata do controle de servidor.

As expressões de ligação de dados usam o Eval e Bind métodos para ligar dados a controles e enviar alterações de volta para o banco de dados. O Eval método é um estático (somente leitura) que usa o valor de um campo de dados e o retorna como uma seqüência de caracteres. O Bind método dá suporte à funcionalidade de leitura/gravação com a capacidade de recuperar os valores de controles ligados a dados e enviar as alterações feitas de volta ao banco de dados.

Você pode vincular a dados XML de um XmlDataSource controle usando o XPath e XPathSelect métodos, bem como o XPathBinder classe. Para obter mais informações, consulte Visão Geral sobre o Controle de Servidor Web XmlDataSource.

Exemplo

O exemplo de código a seguir demonstra como você pode vincular dados de propriedades em um aplicativo ASP.Controle de servidor de rede. Quando um usuário seleciona um estado da DropDownList Web server control, o Label controle de servidor Web é vinculado contra o item selecionado na lista e exibe o estado selecionado.

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