DataBinder.Eval メソッド

リファレンス

定義

名前空間:: System.Web.UI

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

リフレクションを使用して、オブジェクトに対するデータバインディング式を実行時に解析および評価します。

オーバーロード

Eval(Object, String)	実行時にデータバインディング式を評価します。
Eval(Object, String, String)	実行時にデータバインディング式を評価し、その結果を文字列として書式設定します。

注釈

.NET Framework 4.5 以降では、モデルバインドを使用して、以前のバージョンのデータバインディングを使用して実行する必要があったタスクの一部を簡略化できます。 Web Formsでのモデルバインドの使用に関するチュートリアルシリーズについては、「モデルバインドとWeb Forms」を参照してください。

Eval(Object, String)

実行時にデータバインディング式を評価します。

public:
 static System::Object ^ Eval(System::Object ^ container, System::String ^ expression);

public static object Eval (object container, string expression);

static member Eval : obj * string -> obj

Public Shared Function Eval (container As Object, expression As String) As Object

パラメーター

container: Object

式の評価に使用するオブジェクト参照。これは、ページの指定された言語による有効なオブジェクト識別子である必要があります。

expression: String

バインドされたコントロールプロパティに配置される、container オブジェクトからパブリックプロパティ値へのナビゲーションパス。これは、C# や Visual Basic など Tables[0].DefaultView.[0].Price 、ピリオドで区切られたプロパティ名または Tables(0).DefaultView.(0).Price フィールド名の文字列である必要があります。

戻り値

Object

データバインディング式の評価の結果として取得される Object インスタンス。

例外

ArgumentNullException

expression が null か、トリムすると空の文字列になります。

例

次の例では、メソッドを使用してデータを Eval コントロールにバインドする方法を Repeater 示します。 Product という名前のデータクラスが必要です。

public class Product
{
    public int ProductID { get; set; }
    public string Name { get; set; }
    public double Price { get; set; }
}

Public Class Product
    Public Property ProductID As Integer
    Public Property Name As String
    Public Property Price As Double
End Class

分離コードファイルはテストデータを読み込み、そのデータをコントロールに Repeater バインドします。

public partial class ShowProducts : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        var products = new List<Product>();
        products.Add(new Product() { ProductID = 1, Name = "Bike", Price = 150.00 });
        products.Add(new Product() { ProductID = 2, Name = "Helmet", Price = 19.99 });
        products.Add(new Product() { ProductID = 3, Name = "Tire", Price = 10.00 });

        ProductList.DataSource = products;
        ProductList.DataBind();
    }
}

Public Class ShowProducts
    Inherits System.Web.UI.Page

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
        Dim products As New List(Of Product)()
        products.Add(New Product With {.ProductID = 1, .Name = "Bike", .Price = 150.0})
        products.Add(New Product With {.ProductID = 2, .Name = "Helmet", .Price = 19.99})
        products.Add(New Product With {.ProductID = 3, .Name = "Tire", .Price = 10.0})

        ProductList.DataSource = products
        ProductList.DataBind()
    End Sub

End Class

コントロールの宣言型構文 Repeater では、パラメーターにとの Eval メソッド Container.DataItem を container 使用します。

<asp:Repeater ID="ProductList" runat="server">
    <ItemTemplate>
        <%# DataBinder.Eval(Container.DataItem, "Name") %> for only <%# DataBinder.Eval(Container.DataItem, "Price", "{0:c}") %>
        <br />
        <a href='<%# DataBinder.Eval(Container.DataItem, "ProductID", "details.asp?id={0}") %>'>See Details</a>
        <br />
        <br />
    </ItemTemplate>
</asp:Repeater>

<asp:Repeater ID="ProductList" runat="server">
    <ItemTemplate>
        <%# DataBinder.Eval(Container.DataItem, "Name") %> for only <%# DataBinder.Eval(Container.DataItem, "Price", "{0:c}") %>
        <br />
        <a href='<%# DataBinder.Eval(Container.DataItem, "ProductID", "details.asp?id={0}") %>'>See Details</a>
        <br />
        <br />
    </ItemTemplate>
</asp:Repeater>

または、パラメーターを含めずに関数をcontainer呼び出Evalすことができます。

<asp:Repeater ID="ProductList" runat="server">
    <ItemTemplate>
        <%# Eval("Name") %> for only <%# Eval("Price", "{0:c}") %>
        <br />
        <a href='<%# Eval("ProductID", "details.asp?id={0}") %>'>See Details</a>
        <br />
        <br />
    </ItemTemplate>
</asp:Repeater>

<asp:Repeater ID="ProductList" runat="server">
    <ItemTemplate>
        <%# Eval("Name") %> for only <%# Eval("Price", "{0:c}") %>
        <br />
        <a href='<%# Eval("ProductID", "details.asp?id={0}") %>'>See Details</a>
        <br />
        <br />
    </ItemTemplate>
</asp:Repeater>

注釈

パラメーターの expression 値は、パブリックプロパティに評価される必要があります。

このメソッドは、Visual Studio などの迅速なアプリケーション開発 (RAD) デザイナーでデータバインディングを作成すると自動的に呼び出されます。これを宣言的に使用して、テキスト文字列へのキャストを簡略化することもできます。これを行うには、標準の <%# %> ASP.NET データバインディングで使用される式構文を使用します。

このメソッドは、テンプレート化されたリスト内のコントロールにデータをバインドする場合に特に便利です。

注意

このメソッドは遅延バインディング評価を実行するため、実行時にリフレクションを使用すると、標準の ASP.NET データバインディング構文と比較してパフォーマンスが著しく低下する可能性があります。

リスト Web コントロール (、、 Repeatercontainer などDataList GridView DetailsView) の場合は、にするContainer.DataItem必要があります。ページに対してバインドする場合は、 container をにする Page必要があります。

こちらもご覧ください

適用対象

Eval(Object, String, String)

実行時にデータバインディング式を評価し、その結果を文字列として書式設定します。

public:
 static System::String ^ Eval(System::Object ^ container, System::String ^ expression, System::String ^ format);

public static string Eval (object container, string expression, string format);

static member Eval : obj * string * string -> string

Public Shared Function Eval (container As Object, expression As String, format As String) As String

パラメーター

container: Object

式の評価に使用するオブジェクト参照。これは、ページの指定された言語による有効なオブジェクト識別子である必要があります。

expression: String

format: String

データバインディング式によって返された Object インスタンスを String オブジェクトに変換する (Format(String, Object) で使用されているような) .NET Framework 書式指定文字列。

戻り値

String

データバインディング式を評価してその式を文字列型に変換した結果として取得される String オブジェクト。

例

public class Product
{
    public int ProductID { get; set; }
    public string Name { get; set; }
    public double Price { get; set; }
}

Public Class Product
    Public Property ProductID As Integer
    Public Property Name As String
    Public Property Price As Double
End Class

分離コードファイルはテストデータを読み込み、そのデータをコントロールに Repeater バインドします。

public partial class ShowProducts : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        var products = new List<Product>();
        products.Add(new Product() { ProductID = 1, Name = "Bike", Price = 150.00 });
        products.Add(new Product() { ProductID = 2, Name = "Helmet", Price = 19.99 });
        products.Add(new Product() { ProductID = 3, Name = "Tire", Price = 10.00 });

        ProductList.DataSource = products;
        ProductList.DataBind();
    }
}

Public Class ShowProducts
    Inherits System.Web.UI.Page

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
        Dim products As New List(Of Product)()
        products.Add(New Product With {.ProductID = 1, .Name = "Bike", .Price = 150.0})
        products.Add(New Product With {.ProductID = 2, .Name = "Helmet", .Price = 19.99})
        products.Add(New Product With {.ProductID = 3, .Name = "Tire", .Price = 10.0})

        ProductList.DataSource = products
        ProductList.DataBind()
    End Sub

End Class

コントロールの宣言型構文 Repeater では、パラメーターにとの Eval メソッド Container.DataItem を container 使用します。

<asp:Repeater ID="ProductList" runat="server">
    <ItemTemplate>
        <%# DataBinder.Eval(Container.DataItem, "Name") %> for only <%# DataBinder.Eval(Container.DataItem, "Price", "{0:c}") %>
        <br />
        <a href='<%# DataBinder.Eval(Container.DataItem, "ProductID", "details.asp?id={0}") %>'>See Details</a>
        <br />
        <br />
    </ItemTemplate>
</asp:Repeater>

<asp:Repeater ID="ProductList" runat="server">
    <ItemTemplate>
        <%# DataBinder.Eval(Container.DataItem, "Name") %> for only <%# DataBinder.Eval(Container.DataItem, "Price", "{0:c}") %>
        <br />
        <a href='<%# DataBinder.Eval(Container.DataItem, "ProductID", "details.asp?id={0}") %>'>See Details</a>
        <br />
        <br />
    </ItemTemplate>
</asp:Repeater>

または、パラメーターを含めずに関数をcontainer呼び出Evalすことができます。

<asp:Repeater ID="ProductList" runat="server">
    <ItemTemplate>
        <%# Eval("Name") %> for only <%# Eval("Price", "{0:c}") %>
        <br />
        <a href='<%# Eval("ProductID", "details.asp?id={0}") %>'>See Details</a>
        <br />
        <br />
    </ItemTemplate>
</asp:Repeater>

<asp:Repeater ID="ProductList" runat="server">
    <ItemTemplate>
        <%# Eval("Name") %> for only <%# Eval("Price", "{0:c}") %>
        <br />
        <a href='<%# Eval("ProductID", "details.asp?id={0}") %>'>See Details</a>
        <br />
        <br />
    </ItemTemplate>
</asp:Repeater>

注釈

の expression 値は、パブリックプロパティに評価される必要があります。

.NET Frameworkの書式指定文字列の詳細については、「型の書式設定」を参照してください。

このメソッドは、Visual Studio などの迅速なアプリケーション開発 (RAD) デザイナーでデータバインディングを作成すると自動的に呼び出されます。これを宣言的に使用して、データバインディング式の結果をにString変換Objectすることもできます。メソッドを宣言的に使用するには、標準の <%# %> ASP.NET データバインディングで使用される式構文を使用します。

このメソッドは、テンプレート化されたリスト内のコントロールにデータをバインドする場合に特に便利です。

注意

このメソッドは遅延バインディング評価を実行するため、実行時にリフレクションを使用すると、標準の ASP.NET データバインディング構文と比較してパフォーマンスが著しく低下する可能性があります。特に文字列の書式設定が不要な場合は、このメソッドを慎重に使用してください。

こちらもご覧ください

適用対象

次の方法で共有

DataBinder.Eval メソッド

定義

オーバーロード

注釈

Eval(Object, String)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

Eval(Object, String, String)

パラメーター

戻り値

例

注釈

こちらもご覧ください

適用対象

その他のリソース