Sintaxe de expressões de ligação de dados

Artigo
08/25/2010

Expressões de vinculação de dados crie ligações entre uma propriedade do controle do servidor e um de dados de fonte 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 emparelhar atributo/valor 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 de controle para o qual essa vinculação de dados é declarada.
expressão de vinculaçã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 vinculaçã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 as ligações entre fontes de dados e propriedades de controle do servidor. Praticamente qualquer propriedade do controle do servidor pode ser limite contra 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 vinculação de dados usam o Eval e Bind métodos para BIND dados a controles e enviar alterações de volta para o banco de dados. The Eval método é um método (somente leitura) estático que usa o valor de um campo de dados e o retorna sistema autônomo uma seqüência de caracteres. The Bind método oferece suporte à funcionalidade de leitura/gravar a capacidade de recuperar os valores de controles ligados a dados e enviar as alterações feitas no banco de dados.

Você pode BIND a dados XML por um XmlDataSource controle usando o XPath e XPathSelect métodos, bem sistema autônomo 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 BIND dados de propriedades em um controle de servidor ASP.NET. Quando um usuário seleciona um estado a partir de DropDownList Controle de servidor, da Web do Label Controle de servidor Web é limite 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>