Freigeben über

XPathBinder.Eval Methode

  • Referenz

Definition

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

Analysiert einen XPath-Datenbindungsausdruck zur Laufzeit mit einem IXPathNavigable-Objekt und wertet diesen aus.

Überlädt

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 wird.
Eval(Object, String, IXmlNamespaceResolver)

Wertet mithilfe des IXmlNamespaceResolver-Objekts, das zur Auflösung von Namespacepräfixen im XPath-Ausdruck angegeben wird, XPath-Datenbindungsausdrücke zur Laufzeit aus und formatiert das Ergebnis als Text, der im anfordernden Browser angezeigt wird.
Eval(Object, String, String, IXmlNamespaceResolver)

Wertet mithilfe des IXmlNamespaceResolver-Objekts, das zur Auflösung von Namespacepräfixen im XPath-Ausdruck angegeben wird, XPath-Datenbindungsausdrücke zur Laufzeit aus und formatiert das Ergebnis als Text, der im anfordernden Browser angezeigt wird.

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. Dabei muss es sich um einen gültigen Objektbezeichner in der angegebenen Sprache der Seite handeln.

xPath
String

Die XPath-Abfrage vom container zum Eigenschaftswert, der in der Eigenschaft des gebundenen Steuerelements platziert wird.

Gibt zurück

Object

Ein Object, das bei der Auswertung des Datenbindungsausdrucks entsteht.

Ausnahmen

ArgumentNullException

Der container-Parameter oder der xpath-Parameter ist null.

ArgumentException

Das in container angegebene Objekt ist kein IXPathNavigable-Objekt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein XmlDataSource Steuerelement mit einem vorlagenbasierten Repeater Steuerelement zum Anzeigen von XML-Daten verwendet wird. Dieses Beispiel umfasst zwei Teile:

  • Eine Web Forms Seite, auf der XML-Daten angezeigt werden.

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

Der erste Teil des Beispiels zeigt eine Web Forms Seite, auf der XML-Daten angezeigt werden, auf die über ein XmlDataSource Steuerelement zugegriffen wird. Ein Repeater Steuerelement verwendet die vereinfachte Eval(Object, String) Methodensyntax, um an Datenelemente innerhalb des XML-Dokuments zu binden, das das 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.xml bereit, die als Quelle der Daten verwendet wird, die auf der oben definierten Web Forms Seite angezeigt werden.

<?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 %> , die auch in standardbasierten ASP.NET Datenbindung verwendet werden, um den Datenbindungsausdruck herum platzieren.

Für alle Listen ASP.NET Serversteuerelemente, z DataList. B. , DataGridoder Repeater, sollte der container Parameter sein Container.DataItem. Wenn Sie eine Bindung für die Seite ausführen, 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 wird.

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. Dabei muss es sich um einen gültigen Objektbezeichner in der angegebenen Sprache der Seite handeln.

xPath
String

Die XPath-Abfrage vom container zum Eigenschaftswert, der in der Eigenschaft des gebundenen Steuerelements platziert werden soll.

format
String

Eine Formatzeichenfolge von .NET Framework (ähnlich der Zeichenfolgen, die von Format(String, Object) verwendet werden), die das IXPathNavigable-Objekt, das Ergebnis der Auswertung des Datenbindungsausdrucks, in einen String für die Anzeige im anfordernden Browser konvertiert.

Gibt zurück

String

Ein String, der bei der Auswertung des Datenbindungsausdrucks und der Konvertierung in einen Zeichenfolgentyp entsteht.

Ausnahmen

ArgumentNullException

Der container-Parameter oder der xpath-Parameter ist null.

ArgumentException

Das in container angegebene Objekt ist kein IXPathNavigable.

Hinweise

Weitere Informationen zu Formatzeichenfolgen 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 %> , die auch in standardbasierten ASP.NET Datenbindung verwendet werden, um den Datenbindungsausdruck herum platzieren.

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

Weitere Informationen

Gilt für:

Eval(Object, String, IXmlNamespaceResolver)

Wertet mithilfe des IXmlNamespaceResolver-Objekts, das zur Auflösung von Namespacepräfixen im XPath-Ausdruck angegeben wird, XPath-Datenbindungsausdrücke zur Laufzeit aus und formatiert das Ergebnis als Text, der im anfordernden Browser angezeigt wird.

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. Dabei muss es sich um einen gültigen Objektbezeichner in der angegebenen Sprache der Seite handeln.

xPath
String

Die XPath-Abfrage vom container zum Eigenschaftswert, der in der Eigenschaft des gebundenen Steuerelements platziert werden soll.

resolver
IXmlNamespaceResolver

Das zum Auflösen von Namespacepräfixen im XPath-Ausdruck verwendete IXmlNamespaceResolver-Objekt.

Gibt zurück

Object

Ein Object, das sich bei der Auswertung des Datenbindungsausdrucks ergibt.

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 %> , die auch in standardbasierten ASP.NET Datenbindung verwendet werden, um den Datenbindungsausdruck herum platzieren. Der Datenbindungsausdruck enthält den XPath-Ausdruck und ein IXmlNamespaceResolver Objekt zum Auflösen des Namespaceverweis.

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

Gilt für:

Eval(Object, String, String, IXmlNamespaceResolver)

Wertet mithilfe des IXmlNamespaceResolver-Objekts, das zur Auflösung von Namespacepräfixen im XPath-Ausdruck angegeben wird, XPath-Datenbindungsausdrücke zur Laufzeit aus und formatiert das Ergebnis als Text, der im anfordernden Browser angezeigt wird.

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. Dabei muss es sich um einen gültigen Objektbezeichner in der angegebenen Sprache der Seite handeln.

xPath
String

Die XPath-Abfrage vom container zum Eigenschaftswert, der in der Eigenschaft des gebundenen Steuerelements platziert werden soll.

format
String

Eine Formatzeichenfolge von .NET Framework (ähnlich der Zeichenfolgen, die von Format(String, Object) verwendet werden), die das IXPathNavigable-Objekt, das Ergebnis der Auswertung des Datenbindungsausdrucks, in einen String für die Anzeige im anfordernden Browser konvertiert.

resolver
IXmlNamespaceResolver

Das zum Auflösen von Namespacepräfixen im XPath-Ausdruck verwendete IXmlNamespaceResolver-Objekt.

Gibt zurück

String

Ein String, der bei der Auswertung des Datenbindungsausdrucks und der Konvertierung in einen Zeichenfolgentyp entsteht.

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 %> , die auch in standardbasierten ASP.NET Datenbindung verwendet werden, um den Datenbindungsausdruck herum platzieren. Der Datenbindungsausdruck enthält den XPath-Ausdruck und ein IXmlNamespaceResolver Objekt zum Auflösen des Namespaceverweis.

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

Gilt für: