Data-Binding Expression Syntax

Artigo
05/28/2012

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

Expressões de ligação de dados criar ligações entre uma propriedade de controle de servidor e um de dados de origem quando o DataBind método é chamado na página. Você pode incluir expressões de vinculação de dados no 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.

Remarks

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

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

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 método estático de (somente leitura) que usa o valor de um campo de dados e o retorna como uma seqüência de caracteres. O Bind método oferece suporte à funcionalidade de leitura/gravação com a capacidade de recuperar os valores dos controles ligados a dados e enviar as alterações feitas no banco de dados.

Você pode vincular a dados XML de um XmlDataSource controlar usando o XPath e XPathSelect métodos, bem como o XPathBinder classe. Para obter mais informações, consulte XmlDataSource Web Server Control Overview.

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 é vinculado contra o item selecionado na lista de controle de servidor Web 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>