XPathBinder.Eval Methode
Definition
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 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.