DataBinder Класс

Определение

Предоставляет поддержку для конструкторов быстрой разработки приложений (RAD) в формировании и синтаксическом анализе выражений привязки данных.Provides support for rapid application development (RAD) designers to generate and parse data-binding expression syntax. Этот класс не наследуется.This class cannot be inherited.

public ref class DataBinder sealed
public sealed class DataBinder
type DataBinder = class
Public NotInheritable Class DataBinder
Наследование
DataBinder

Примеры

В GetPropertyValue следующем примере статический метод используется для заполнения полей Repeater элемента управления с помощью ArrayList Product объекта.The following example uses the static GetPropertyValue method to populate the fields of a Repeater control using an ArrayList of Product objects. Eval Метод можно применить с тем же синтаксисом, но он не будет выполняться так быстро.The Eval method could be applied with the same syntax, but it would not perform as quickly.

В этом примере используется пользовательский Product класс, предоставляющий строковое Model свойство и числовое UnitPrice свойство.This example uses a custom Product class which exposes a string Model property and a numeric UnitPrice property.

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

Следующий код является пользовательским Product классом.The following code is the custom Product class. Этот код следует включать в отдельный файл класса в каталоге App_Code, например Product.cs или Product. vb.This code should be included in a separate class file in the App_Code directory, such as Product.cs or 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

Комментарии

Перегруженный статический Eval метод этого класса можно использовать в синтаксисе привязки данных на веб-странице ASP.NET.You can use the overloaded static Eval method of this class in data-binding syntax in an ASP.NET Web page. Это обеспечивает более простой синтаксис для работы, чем стандартная привязка данных.This provides an easier syntax to work with than standard data binding. Однако, поскольку DataBinder.Eval обеспечивает автоматическое преобразование типов, это может привести к снижению производительности.However, because DataBinder.Eval provides automatic type conversion, it can result in slower performance.

Дополнительные сведения о привязке данных, выражениях и синтаксисе ASP.NET см. в статье Общие сведения о привязке к базам данных и выражениям привязки данных.For more information about ASP.NET data binding, expressions, and syntax, see Binding to Databases and Data-Binding Expressions Overview.

Начиная с .NET Framework 4,5, можно использовать привязку модели для упрощения некоторых задач, которые были выполнены с помощью привязки данных в более ранних версиях.Starting in .NET Framework 4.5, you can use model binding to simplify some of the tasks that you had to perform through data-binding in earlier versions. Серию руководств по использованию привязки модели с веб-формами см. в разделе Привязка модели и веб-формы.For a tutorial series on using model binding with Web Forms, see Model Binding and Web Forms.

Конструкторы

DataBinder()

Инициализирует новый экземпляр класса DataBinder.Initializes a new instance of the DataBinder class.

Свойства

EnableCaching

Получает или задает значение, указывающее, включено ли кэширование данных во время выполнения.Gets or sets a value that indicates whether data caching is enabled at run time.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
Eval(Object, String)

Обрабатывает выражения привязки данных во время исполнения программы.Evaluates data-binding expressions at run time.

Eval(Object, String, String)

Обрабатывает выражения привязки данных во время выполнения и представляет результат в виде строки.Evaluates data-binding expressions at run time and formats the result as a string.

GetDataItem(Object)

Возвращает объявляемый элемент данных объекта.Retrieves an object's declared data item.

GetDataItem(Object, Boolean)

Возвращает объявляемый элемент данных объекта, обозначающий успешное выполнение или сбой.Retrieves an object's declared data item, indicating success or failure.

GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetIndexedPropertyValue(Object, String)

Возвращает значение свойства указанного контейнера и путь перемещения.Retrieves the value of a property of the specified container and navigation path.

GetIndexedPropertyValue(Object, String, String)

Возвращает значение указанного свойства заданного контейнера и форматирует результат.Retrieves the value of the specified property for the specified container, and then formats the results.

GetPropertyValue(Object, String)

Возвращает значение указанного свойства заданного объекта.Retrieves the value of the specified property of the specified object.

GetPropertyValue(Object, String, String)

Возвращает значение указанного свойства заданного объекта и форматирует результат.Retrieves the value of the specified property of the specified object, and then formats the results.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
IsBindableType(Type)

Определяет, можно ли привязать указанный тип данных.Determines whether the specified data type can be bound.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к

Дополнительно