DataBinder Classe

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Fornece suporte para designers de RAD (desenvolvimento rápido de aplicativos) para gerar e analisar a sintaxe de expressão de associação de dados. Essa classe não pode ser herdada.

public ref class DataBinder sealed
public sealed class DataBinder
type DataBinder = class
Public NotInheritable Class DataBinder
Herança
Object
DataBinder

Exemplos

O exemplo a seguir usa o método estático GetPropertyValue para preencher os campos de um Repeater controle usando um ArrayList dos Product objetos. O Eval método poderia ser aplicado com a mesma sintaxe, mas não seria executado tão rapidamente.

Este exemplo usa uma classe personalizada Product que expõe uma propriedade de cadeia de caracteres Model e uma propriedade numérica UnitPrice .

<%@ Page Language="C#" %>
<%@ Import Namespace="ASPSample" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void  Page_Load(object sender, EventArgs e)
{
        // Create and populate an ArrayList to store the products.
        ArrayList ProductList = new ArrayList();
        ProductList.Add(new Product("Standard", 99.95));
        ProductList.Add(new Product("Deluxe", 159.95));

        // Bind the array list to Repeater
        ListRepeater.DataSource = ProductList;
        ListRepeater.DataBind();
}
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>DataBinder Example</title>
</head>
<body>
<form id="Form2" runat="server">
<table>
<asp:Repeater id="ListRepeater" runat="server">
    <HeaderTemplate>
    <tr>
        <th style="width:50; text-align:left">Model</th>
        <th style="width:100; text-align:right">Unit Price</th>
    </tr>
    </HeaderTemplate>
    <ItemTemplate>
    <tr>
        <!-- Databind to the Product information using the DataBinder methods. 
             The Container.DataItem refers to the ArrayList object bound to 
             the ASP:Repeater in the Page Load event. -->
        <td>
            <%#DataBinder.GetPropertyValue(Container.DataItem, "Model")%>
        </td>
        <!-- Format the UnitPrice as currency. ({0:c}) -->
        <td style="text-align:right">
            <%#DataBinder.GetPropertyValue(Container.DataItem,
                         "UnitPrice", "{0:c}")%>
        </td>
    </tr>
    </ItemTemplate>
</asp:Repeater>
</table>
</form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ Import Namespace="ASPSample" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    Private Sub Page_Load(ByVal sender As System.Object, _
        ByVal e As System.EventArgs) Handles MyBase.Load

        ' Create and populate an ArrayList to store the products.
        Dim ProductList As New ArrayList
        ProductList.Add(New Product("Standard", 99.95))
        ProductList.Add(New Product("Deluxe", 159.95))

        ' Bind the array list to Repeater
        ListRepeater.DataSource = ProductList
        ListRepeater.DataBind()

    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>DataBinder Example</title>
</head>
<body>
<form id="Form2" runat="server">
<table>
<asp:Repeater id="ListRepeater" runat="server">
    <HeaderTemplate>
    <tr>
        <th style="width:50; text-align:left">Model</th>
        <th style="width:100; text-align:right">Unit Price</th>
    </tr>
    </HeaderTemplate>
    <ItemTemplate>
    <tr>
        <!-- Databind to the Product information using the DataBinder methods. 
             The Container.DataItem refers to the ArrayList object bound to 
             the ASP:Repeater in the Page Load event. -->
        <td>
            <%#DataBinder.GetPropertyValue(Container.DataItem, "Model")%>
        </td>
        <!-- Format the UnitPrice as currency. ({0:c}) -->
        <td style="text-align:right">
            <%#DataBinder.GetPropertyValue(Container.DataItem, _
                         "UnitPrice", "{0:c}")%>
        </td>
    </tr>
    </ItemTemplate>
</asp:Repeater>
</table>
</form>
</body>
</html>

O código a seguir é a classe personalizada Product . Esse código deve ser incluído em um arquivo de classe separado no diretório App_Code, como Product.cs ou Product.vb.

namespace ASPSample
{

    public class Product
    {
        string _Model;
        double _UnitPrice;

        public Product(string Model, double UnitPrice)
        {
            _Model = Model;
            _UnitPrice = UnitPrice;
        }

        // The product Model.
        public string Model
        {
            get {return _Model;}
            set {_Model = value;}
        }
            
        // The price of the each product.
        public double UnitPrice
        {
            get {return _UnitPrice;}
            set {_UnitPrice = value;}
        }
    }
}

Namespace ASPSample

    Public Class Product
        Private _Model As String
        Private _UnitPrice As Double

        ' The product Model.
        Public Property Model() As String
            Get
                Return _Model
            End Get
            Set(ByVal Value As String)
                _Model = Value
            End Set
        End Property

        ' The price of the each product.
        Public Property UnitPrice() As Double
            Get
                Return _UnitPrice
            End Get
            Set(ByVal Value As Double)
                _UnitPrice = Value
            End Set
        End Property


        Public Sub New(ByVal Model As String, ByVal UnitPrice As Double)
            _Model = Model
            _UnitPrice = UnitPrice
        End Sub

    End Class

End Namespace

Comentários

Você pode usar o método Eval estático sobrecarregado dessa classe na sintaxe de associação de dados em uma página da Web ASP.NET. Isso fornece uma sintaxe mais fácil de trabalhar do que a associação de dados padrão. No entanto, como DataBinder.Eval fornece conversão automática de tipo, isso pode resultar em um desempenho mais lento.

Para obter mais informações sobre ASP.NET associação de dados, expressões e sintaxe, consulte Binding to Databases and Data-Binding Expressions Overview.

A partir do .NET Framework 4.5, você pode usar a associação de modelos para simplificar algumas das tarefas que você teve que executar por meio da associação de dados em versões anteriores. Para obter uma série de tutoriais sobre como usar a associação de modelos com Web Forms, consulte Model Binding e Web Forms.

Construtores

Nome Description
DataBinder()

Inicializa uma nova instância da classe DataBinder.

Propriedades

Nome Description
EnableCaching

Obtém ou define um valor que indica se o cache de dados está habilitado em tempo de execução.

Métodos

Nome Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Eval(Object, String, String)

Avalia expressões de associação de dados em tempo de execução e formata o resultado como uma cadeia de caracteres.
Eval(Object, String)

Avalia expressões de associação de dados em tempo de execução.
GetDataItem(Object, Boolean)

Recupera o item de dados declarado de um objeto, indicando êxito ou falha.
GetDataItem(Object)

Recupera o item de dados declarado de um objeto.
GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetIndexedPropertyValue(Object, String, String)

Recupera o valor da propriedade especificada para o contêiner especificado e formata os resultados.
GetIndexedPropertyValue(Object, String)

Recupera o valor de uma propriedade do contêiner e do caminho de navegação especificados.
GetPropertyValue(Object, String, String)

Recupera o valor da propriedade especificada do objeto especificado e formata os resultados.
GetPropertyValue(Object, String)

Recupera o valor da propriedade especificada do objeto especificado.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IsBindableType(Type)

Determina se o tipo de dados especificado pode ser associado.
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também