XPathBinder.Eval 方法

定義

命名空間:: System.Web.UI

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

在執行時解析並評估 XPath 資料綁定表達式與物件的 IXPathNavigable 關聯。

多載

名稱	Description
Eval(Object, String)	執行時評估 XPath 資料綁定表達式。
Eval(Object, String, String)	執行時評估 XPath 資料綁定表達式，並將結果格式化為文字，供請求瀏覽器顯示。
Eval(Object, String, IXmlNamespaceResolver)	執行時評估 XPath 資料綁定表達式，並將結果格式化為文字，在請求瀏覽器中顯示，使用 IXmlNamespaceResolver 指定物件解析 XPath 表達式中的命名空間前綴。
Eval(Object, String, String, IXmlNamespaceResolver)	執行時評估 XPath 資料綁定表達式，並將結果格式化為文字，在請求瀏覽器中顯示，使用 IXmlNamespaceResolver 指定物件解析 XPath 表達式中的命名空間前綴。

Eval(Object, String)

執行時評估 XPath 資料綁定表達式。

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

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

static member Eval : obj * string -> obj

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

參數

container: Object

IXPathNavigable物件參考是該表達式所參考的對象。此物件識別碼必須是頁面指定語言中的有效物件識別碼。

xPath: String

XPath 查詢從到 container 被綁定控制屬性的屬性值。

傳回

Object

這是 Object 由資料綁定表達式的評估所產生的。

例外狀況

ArgumentNullException

container或xpath參數為 null。

ArgumentException

由 container 指定的物件不是 IXPathNavigable 物件。

範例

以下程式碼範例示範如何使用 XmlDataSource 帶有模板控制 Repeater 項的控制項來顯示 XML 資料。這個例子有兩部分：

一個顯示 XML 資料的網頁表單頁面。
一個包含資料的 XML 檔案。

範例的第一部分展示了一個網頁表單頁面，顯示透過 XmlDataSource 控制項存取的 XML 資料。 Repeater控制項使用簡化Eval(Object, String)的方法語法來綁定該 XmlDataSource XML 文件中的資料項目。它使用該 Select(Object, String) 方法來取得 IEnumerable 清單，並將其指派為控制項的延遲綁定 DataSource 屬性 Repeater 。

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:XmlDataSource
        runat="server"
        id="XmlDataSource1"
        DataFile="bookstore2.xml"
        XPath="bookstore/genre[@name='fiction']" />

      <asp:Repeater
        runat="server"
        DataSourceID="XmlDataSource1">
        <ItemTemplate>
            <h1><%# XPath ("book/title") %></h1>
            <b>Author:</b>
            <%# XPath ("book/author/firstname") %>
            <%# XPath ("book/author/lastname") %>
            <asp:Repeater
                 DataSource='<%# XPathSelect ("book/chapters") %>'
                 runat="server">
                <ItemTemplate>
                     <%# XPath ("chapter/@name") %>
                </ItemTemplate>
            </asp:Repeater>
        </ItemTemplate>
    </asp:Repeater>
  </form>
  </body>
</html>

<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:XmlDataSource
        runat="server"
        id="XmlDataSource1"
        DataFile="bookstore2.xml"
        XPath="bookstore/genre[@name='fiction']" />

      <asp:Repeater
        runat="server"
        DataSourceID="XmlDataSource1">
        <ItemTemplate>
            <h1><%# XPath ("book/title") %></h1>
            <b>Author:</b>
            <%# XPath ("book/author/firstname") %>
            <%# XPath ("book/author/lastname") %>
            <asp:Repeater
                 DataSource='<%# XPathSelect ("book/chapters") %>'
                 runat="server">
                <ItemTemplate>
                     <%# XPath ("chapter/@name") %>
                </ItemTemplate>
            </asp:Repeater>
        </ItemTemplate>
    </asp:Repeater>
  </form>
  </body>
</html>

第二個範例提供了 XML 檔案 Bookstore2.xml，作為上述網頁表單頁面中顯示資料的來源。

<?xml version="1.0" encoding="iso-8859-1"?>
  <bookstore>
    <genre name="fiction">
      <book ISBN="10-861003-324">
        <author>
          <firstname>test</firstname>
          <lastname>test2</lastname>
        </author>
        <title>The Handmaid's Tale</title>
        <price>12.95</price>
        <chapters>
          <chapter num="1" name="Introduction" />
          <chapter num="2" name="Body" />
          <chapter num="3" name="Conclusion" />
        </chapters>
      </book>
    </genre>
    <genre name="nonfiction">
      <book genre="nonfiction" ISBN="1-861001-57-5">
        <author>
          <firstname>test3</firstname>
          <lastname>test4</lastname>
        </author>
        <title>Pride And Prejudice</title>
        <price>24.95</price>
        <chapters>
          <chapter num="1" name="Introduction" />
          <chapter num="2" name="Body" />
          <chapter num="3" name="Conclusion" />
        </chapters>
      </book>
    </genre>
  </bookstore>

備註

如果你想簡化將 XML 節點鑄造成文字字串以便在瀏覽器上顯示，也可以使用宣 Eval 告式方法。為此，您必須在資料綁定表達式周圍放置 <%# 和 %> 標籤，這些標籤也用於標準 ASP.NET 資料綁定。

對於列表中 ASP.NET 伺服器控制項，如 DataList、 DataGrid、 Repeater或，參數 container 應為 Container.DataItem。如果你綁定在頁面上， container 參數應該是 Page。

另請參閱

適用於

Eval(Object, String, String)

執行時評估 XPath 資料綁定表達式，並將結果格式化為文字，供請求瀏覽器顯示。

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

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

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

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

參數

container: Object

IXPathNavigable物件參考是該表達式所參考的對象。此物件識別碼必須是頁面指定語言中的有效物件識別碼。

xPath: String

XPath 查詢從到 container 要放在綁定控制屬性中的屬性值。

format: String

一個 .NET Framework 格式字串，類似於所Format(String, Object)使用的，將物件（由資料綁定運算式的評估結果）轉換IXPathNavigable成請求瀏覽器可顯示的。String

傳回

String

String A 是透過評估資料綁定表達式並轉換為字串型別而產生的。

例外狀況

ArgumentNullException

container或xpath參數為 null。

ArgumentException

由指定的 container 物件並非 IXPathNavigable。

備註

想了解更多關於 .NET Framework 格式字串的資訊，請參見格式類型。

如果你想簡化將 XML 節點鑄造成文字字串以便在瀏覽器中顯示，可以使用宣 Eval(Object, String) 告式的方法。為此，您必須在資料綁定表達式周圍放置 <%# 和 %> 標籤，這些標籤也用於標準 ASP.NET 資料綁定。

另請參閱

.NET 中的格式設定類型

適用於

Eval(Object, String, IXmlNamespaceResolver)

執行時評估 XPath 資料綁定表達式，並將結果格式化為文字，在請求瀏覽器中顯示，使用 IXmlNamespaceResolver 指定物件解析 XPath 表達式中的命名空間前綴。

public:
 static System::Object ^ Eval(System::Object ^ container, System::String ^ xPath, System::Xml::IXmlNamespaceResolver ^ resolver);

public static object Eval(object container, string xPath, System.Xml.IXmlNamespaceResolver resolver);

static member Eval : obj * string * System.Xml.IXmlNamespaceResolver -> obj

Public Shared Function Eval (container As Object, xPath As String, resolver As IXmlNamespaceResolver) As Object

參數

container: Object

IXPathNavigable物件參考是該表達式所參考的對象。此物件識別碼必須是頁面指定語言中的有效物件識別碼。

xPath: String

XPath 查詢從到 container 要放在綁定控制屬性中的屬性值。

resolver: IXmlNamespaceResolver

IXmlNamespaceResolver用於解析 XPath 表達式中命名空間前綴的物件。

傳回

Object

Object A 是由資料綁定表達式的評估所產生。

備註

如果你想簡化將 XML 節點鑄造成文字字串以便在瀏覽器中顯示，可以使用宣 Eval 告式的方法。為此，您必須在資料綁定表達式周圍放置 <%# 和 %> 標籤，這些標籤也用於標準 ASP.NET 資料綁定。資料綁定表達式包含 XPath 表達式及 IXmlNamespaceResolver 一個用來解析命名空間參考的物件。

適用於

Eval(Object, String, String, IXmlNamespaceResolver)

執行時評估 XPath 資料綁定表達式，並將結果格式化為文字，在請求瀏覽器中顯示，使用 IXmlNamespaceResolver 指定物件解析 XPath 表達式中的命名空間前綴。

public:
 static System::String ^ Eval(System::Object ^ container, System::String ^ xPath, System::String ^ format, System::Xml::IXmlNamespaceResolver ^ resolver);

public static string Eval(object container, string xPath, string format, System.Xml.IXmlNamespaceResolver resolver);

static member Eval : obj * string * string * System.Xml.IXmlNamespaceResolver -> string

Public Shared Function Eval (container As Object, xPath As String, format As String, resolver As IXmlNamespaceResolver) As String

參數

container: Object

IXPathNavigable物件參考是該表達式所參考的對象。此物件識別碼必須是頁面指定語言中的有效物件識別碼。

xPath: String

XPath 查詢從到 container 要放在綁定控制屬性中的屬性值。

format: String

一個 .NET Framework 格式字串，類似於所Format(String, Object)使用的，將物件（由資料綁定運算式的評估結果）轉換IXPathNavigable成請求瀏覽器可顯示的。String

resolver: IXmlNamespaceResolver

IXmlNamespaceResolver用於解析 XPath 表達式中命名空間前綴的物件。

傳回

String

String A 是透過評估資料綁定表達式並轉換為字串型別而產生的。

備註

適用於

意見反應

此頁面對您有幫助嗎？

共用方式為

XPathBinder.Eval 方法

定義

多載

Eval(Object, String)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

Eval(Object, String, String)

參數

傳回

例外狀況

備註

另請參閱

適用於

Eval(Object, String, IXmlNamespaceResolver)

參數

傳回

備註

適用於

Eval(Object, String, String, IXmlNamespaceResolver)

參數

傳回

備註

適用於

意見反應