XPathBinder.Eval Methode

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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.

Weitere Informationen

Formatieren von Typen in .NET

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

Gilt für:

Eval(Object, String, String, IXmlNamespaceResolver)

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

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

Gilt für:

XPathBinder.Eval Methode

Definition

Überlädt

Eval(Object, String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Eval(Object, String, String)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Eval(Object, String, IXmlNamespaceResolver)

Parameter

Gibt zurück

Hinweise

Gilt für:

Eval(Object, String, String, IXmlNamespaceResolver)

Parameter

Gibt zurück

Hinweise

Gilt für:

Feedback

Zusätzliche Ressourcen