Freigeben über


XPathBinder.Eval Methode

Definition

Analysiert und wertet einen XPath-Datenbindungsausdruck für ein IXPathNavigable Objekt zur Laufzeit aus.

Überlädt

Name Beschreibung
Eval(Object, String)

Wertet XPath-Datenbindungsausdrücke zur Laufzeit aus.

Eval(Object, String, String)

Wertet XPath-Datenbindungsausdrücke zur Laufzeit aus und formatiert das Ergebnis als Text, der im anfordernden Browser angezeigt werden soll.

Eval(Object, String, IXmlNamespaceResolver)

Wertet XPath-Datenbindungsausdrücke zur Laufzeit aus und formatiert das Ergebnis als Text, der im anfordernden Browser angezeigt werden soll. Dabei wird das IXmlNamespaceResolver angegebene Objekt verwendet, um Namespacepräfixe im XPath-Ausdruck aufzulösen.

Eval(Object, String, String, IXmlNamespaceResolver)

Wertet XPath-Datenbindungsausdrücke zur Laufzeit aus und formatiert das Ergebnis als Text, der im anfordernden Browser angezeigt werden soll. Dabei wird das IXmlNamespaceResolver angegebene Objekt verwendet, um Namespacepräfixe im XPath-Ausdruck aufzulösen.

Eval(Object, String)

Wertet XPath-Datenbindungsausdrücke zur Laufzeit aus.

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

Parameter

container
Object

Der IXPathNavigable Objektverweis, für den der Ausdruck ausgewertet wird. Dies muss ein gültiger Objektbezeichner in der angegebenen Sprache der Seite sein.

xPath
String

Die XPath-Abfrage von container zu dem Eigenschaftswert, der in der gebundenen Steuerelementeigenschaft platziert wird.

Gibt zurück

Ein Object Ergebnis aus der Auswertung des Datenbindungsausdrucks.

Ausnahmen

Der container Parameter ist xpathnull.

Das angegebene container Objekt ist kein IXPathNavigable Objekt.

Beispiele

Im folgenden Codebeispiel wird die Verwendung eines XmlDataSource Steuerelements mit einem vorlagenbasierten Repeater Steuerelement zum Anzeigen von XML-Daten veranschaulicht. Dieses Beispiel enthält zwei Teile:

  • Eine Web Forms-Seite, die XML-Daten anzeigt.

  • Eine XML-Datei, die die Daten enthält.

Der erste Teil des Beispiels zeigt eine Web Forms-Seite, die XML-Daten anzeigt, auf die über ein XmlDataSource Steuerelement zugegriffen wird. Ein Repeater Steuerelement verwendet die vereinfachte Eval(Object, String) Methodensyntax, um eine Bindung an Datenelemente innerhalb des XML-Dokuments zu erstellen, das dies XmlDataSource darstellt. Sie verwendet die Select(Object, String) Methode, um eine IEnumerable Liste abzurufen und sie als spät gebundene DataSource Eigenschaft für das Repeater Steuerelement zuzuweisen.

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

Das zweite Beispiel stellt die XML-Datei Bookstore2.xmlbereit, die als Quelle der in der oben definierten Web Forms-Seite angezeigten Daten verwendet wird.

<?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>

Hinweise

Sie können die Eval Methode deklarativ verwenden, wenn Sie die Umwandlung eines XML-Knotens in eine Textzeichenfolge vereinfachen möchten, die in einem Browser angezeigt werden soll. Dazu müssen Sie die < Tags%# und %> platzieren, die auch in standardbasierten ASP.NET Datenbindung verwendet werden, um den Datenbindungsausdruck herum.

Für eine der Listen-ASP.NET Serversteuerelemente, z DataList. B. , DataGridoder Repeater, sollte der container Parameter sein Container.DataItem. Wenn Sie eine Bindung für die Seite haben, sollte der container Parameter sein Page.

Weitere Informationen

Gilt für:

Eval(Object, String, String)

Wertet XPath-Datenbindungsausdrücke zur Laufzeit aus und formatiert das Ergebnis als Text, der im anfordernden Browser angezeigt werden soll.

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

Parameter

container
Object

Der IXPathNavigable Objektverweis, für den der Ausdruck ausgewertet wird. Dies muss ein gültiger Objektbezeichner in der angegebenen Sprache der Seite sein.

xPath
String

Die XPath-Abfrage aus dem container Eigenschaftswert, der in der gebundenen Steuerelementeigenschaft platziert werden soll.

format
String

Eine .NET Framework-Formatzeichenfolge, ähnlich derjenigen, die verwendet Format(String, Object)wird, die das IXPathNavigable Objekt (das aus der Auswertung des Datenbindungsausdrucks resultiert) in ein String Objekt konvertiert, das vom anfordernden Browser angezeigt werden kann.

Gibt zurück

Ein String Ergebnis aus der Auswertung des Datenbindungsausdrucks und der Konvertierung in einen Zeichenfolgentyp.

Ausnahmen

Der container Parameter ist xpathnull.

Das angegebene container Objekt ist kein IXPathNavigable.

Hinweise

Weitere Informationen zum Formatieren von Zeichenfolgen im .NET Framework finden Sie unter "Formatierungstypen".

Sie können die Eval(Object, String) Methode deklarativ verwenden, wenn Sie die Umwandlung eines XML-Knotens in eine Textzeichenfolge vereinfachen möchten, die in einem Browser angezeigt werden soll. Dazu müssen Sie die < Tags%# und %> platzieren, die auch in standardbasierten ASP.NET Datenbindung verwendet werden, um den Datenbindungsausdruck herum.

Für eine der Listen-ASP.NET Serversteuerelemente, z DataList. B. , DataGridoder Repeater, sollte der container Parameter sein Container.DataItem. Wenn Sie eine Bindung für die Seite haben, sollte der container Parameter sein Page.

Weitere Informationen

Gilt für:

Eval(Object, String, IXmlNamespaceResolver)

Wertet XPath-Datenbindungsausdrücke zur Laufzeit aus und formatiert das Ergebnis als Text, der im anfordernden Browser angezeigt werden soll. Dabei wird das IXmlNamespaceResolver angegebene Objekt verwendet, um Namespacepräfixe im XPath-Ausdruck aufzulösen.

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

Parameter

container
Object

Der IXPathNavigable Objektverweis, für den der Ausdruck ausgewertet wird. Dies muss ein gültiger Objektbezeichner in der angegebenen Sprache der Seite sein.

xPath
String

Die XPath-Abfrage aus dem container Eigenschaftswert, der in der gebundenen Steuerelementeigenschaft platziert werden soll.

resolver
IXmlNamespaceResolver

Das IXmlNamespaceResolver Objekt, das zum Auflösen von Namespacepräfixen im XPath-Ausdruck verwendet wird.

Gibt zurück

Ein Object Ergebnis aus der Auswertung des Datenbindungsausdrucks.

Hinweise

Sie können die Eval Methode deklarativ verwenden, wenn Sie die Umwandlung eines XML-Knotens in eine Textzeichenfolge vereinfachen möchten, die in einem Browser angezeigt werden soll. Dazu müssen Sie die < Tags%# und %> platzieren, die auch in standardbasierten ASP.NET Datenbindung verwendet werden, um den Datenbindungsausdruck herum. Der Datenbindungsausdruck enthält den XPath-Ausdruck und ein IXmlNamespaceResolver Objekt, um den Namespaceverweis aufzulösen.

Für eine der Listen-ASP.NET Serversteuerelemente, z DataList. B. , DataGridoder Repeater, sollte der container Parameter sein Container.DataItem. Wenn Sie eine Bindung für die Seite haben, sollte der container Parameter sein Page.

Gilt für:

Eval(Object, String, String, IXmlNamespaceResolver)

Wertet XPath-Datenbindungsausdrücke zur Laufzeit aus und formatiert das Ergebnis als Text, der im anfordernden Browser angezeigt werden soll. Dabei wird das IXmlNamespaceResolver angegebene Objekt verwendet, um Namespacepräfixe im XPath-Ausdruck aufzulösen.

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

Parameter

container
Object

Der IXPathNavigable Objektverweis, für den der Ausdruck ausgewertet wird. Dies muss ein gültiger Objektbezeichner in der angegebenen Sprache der Seite sein.

xPath
String

Die XPath-Abfrage aus dem container Eigenschaftswert, der in der gebundenen Steuerelementeigenschaft platziert werden soll.

format
String

Eine .NET Framework-Formatzeichenfolge, ähnlich derjenigen, die verwendet Format(String, Object)wird, die das IXPathNavigable Objekt (das aus der Auswertung des Datenbindungsausdrucks resultiert) in ein String Objekt konvertiert, das vom anfordernden Browser angezeigt werden kann.

resolver
IXmlNamespaceResolver

Das IXmlNamespaceResolver Objekt, das zum Auflösen von Namespacepräfixen im XPath-Ausdruck verwendet wird.

Gibt zurück

Ein String Ergebnis aus der Auswertung des Datenbindungsausdrucks und der Konvertierung in einen Zeichenfolgentyp.

Hinweise

Sie können die Eval Methode deklarativ verwenden, wenn Sie die Umwandlung eines XML-Knotens in eine Textzeichenfolge vereinfachen möchten, die in einem Browser angezeigt werden soll. Dazu müssen Sie die < Tags%# und %> platzieren, die auch in standardbasierten ASP.NET Datenbindung verwendet werden, um den Datenbindungsausdruck herum. Der Datenbindungsausdruck enthält den XPath-Ausdruck und ein IXmlNamespaceResolver Objekt, um den Namespaceverweis aufzulösen.

Für eine der Listen-ASP.NET Serversteuerelemente, z DataList. B. , DataGridoder Repeater, sollte der container Parameter sein Container.DataItem. Wenn Sie eine Bindung für die Seite haben, sollte der container Parameter sein Page.

Gilt für: