Freigeben über

TemplateControl.XPath Methode

  • Referenz

Definition

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

Bietet Unterstützung für die Analyse und Auswertung eines XPath-Datenbindungsausdrucks anhand eines Objekts zur Laufzeit.

Überlädt

XPath(String, String, IXmlNamespaceResolver)

Wertet einen XPath-Datenbindungsausdruck mithilfe der angegebenen Präfix- und Namespacezuordnungen für die Namespaceauflösung aus und zeigt mit der angegebenen Formatzeichenfolge das Ergebnis an.
XPath(String, IXmlNamespaceResolver)

Wertet einen XPath-Datenbindungsausdruck mithilfe der angegebenen Präfix- und Namespacezuordnungen für die Namespaceauflösung aus.
XPath(String)

Wertet einen XPath-Datenbindungsausdruck aus.
XPath(String, String)

Wertet mithilfe der angegebenen Formatzeichenfolge einen XPath-Datenbindungsausdruck aus und zeigt das Ergebnis an.

XPath(String, String, IXmlNamespaceResolver)

Wertet einen XPath-Datenbindungsausdruck mithilfe der angegebenen Präfix- und Namespacezuordnungen für die Namespaceauflösung aus und zeigt mit der angegebenen Formatzeichenfolge das Ergebnis an.

protected public:
 System::String ^ XPath(System::String ^ xPathExpression, System::String ^ format, System::Xml::IXmlNamespaceResolver ^ resolver);
protected internal string XPath (string xPathExpression, string format, System.Xml.IXmlNamespaceResolver resolver);
member this.XPath : string * string * System.Xml.IXmlNamespaceResolver -> string
Protected Friend Function XPath (xPathExpression As String, format As String, resolver As IXmlNamespaceResolver) As String

Parameter

xPathExpression
String

Der auszuwertende XPath-Ausdruck. Weitere Informationen finden Sie unter XPathBinder.

format
String

Eine für das Ergebnis geltende .NET Framework-Formatzeichenfolge.

resolver
IXmlNamespaceResolver

Eine Gruppe von Präfix- und Namespacezuordnungen, die für die Namespaceauflösung verwendet werden.

Gibt zurück

String

Eine Zeichenfolge, die bei der Auswertung des Datenbindungsausdrucks und der Konvertierung in einen Zeichenfolgentyp entsteht.

Ausnahmen

InvalidOperationException

Die Datenbindungsmethode kann nur für in einer Page enthaltene Steuerelemente verwendet werden.

Hinweise

Die XPath Methode ruft die XPathBinder.Eval Methode mithilfe der GetDataItem Methode auf, um den Objektverweis zu beheben, für den IXPathNavigable der Ausdruck ausgewertet wird.

Siehe auch

Gilt für

XPath(String, IXmlNamespaceResolver)

Wertet einen XPath-Datenbindungsausdruck mithilfe der angegebenen Präfix- und Namespacezuordnungen für die Namespaceauflösung aus.

protected public:
 System::Object ^ XPath(System::String ^ xPathExpression, System::Xml::IXmlNamespaceResolver ^ resolver);
protected internal object XPath (string xPathExpression, System.Xml.IXmlNamespaceResolver resolver);
member this.XPath : string * System.Xml.IXmlNamespaceResolver -> obj
Protected Friend Function XPath (xPathExpression As String, resolver As IXmlNamespaceResolver) As Object

Parameter

xPathExpression
String

Der auszuwertende XPath-Ausdruck. Weitere Informationen finden Sie unter XPathBinder.

resolver
IXmlNamespaceResolver

Eine Gruppe von Präfix- und Namespacezuordnungen, die für die Namespaceauflösung verwendet werden.

Gibt zurück

Object

Ein Objekt, das bei der Auswertung des Datenbindungsausdrucks entsteht

Ausnahmen

InvalidOperationException

Die Datenbindungsmethode kann nur für in einer Page enthaltene Steuerelemente verwendet werden.

Hinweise

Die XPath Methode ruft die XPathBinder.Eval Methode mithilfe der GetDataItem Methode auf, um den Objektverweis zu beheben, für den IXPathNavigable der Ausdruck ausgewertet wird.

Siehe auch

Gilt für

XPath(String)

Wertet einen XPath-Datenbindungsausdruck aus.

protected public:
 System::Object ^ XPath(System::String ^ xPathExpression);
protected internal object XPath (string xPathExpression);
member this.XPath : string -> obj
Protected Friend Function XPath (xPathExpression As String) As Object

Parameter

xPathExpression
String

Der auszuwertende XPath-Ausdruck. Weitere Informationen finden Sie unter XPathBinder.

Gibt zurück

Object

Ein Objekt, das bei der Auswertung des Datenbindungsausdrucks entsteht

Ausnahmen

InvalidOperationException

Die Datenbindungsmethode kann nur für in einer Page enthaltene Steuerelemente verwendet werden.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die XPath Methode in einem Repeater Steuerelement verwenden.

<%@ 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>TemplateControl XPath and XPathSelect Example</title>
</head>
<body>
    <h3>TemplateControl XPath Example</h3>
    <form id="form1" runat="server">
    <div>
      <asp:XmlDataSource
        id="XmlDataSource1" 
        runat="server"
        XPath="contacts" 
        DataFile="contacts.xml" />    
      <asp:FormView 
        id="FormView1" 
        runat="server" 
        DataSourceID="XmlDataSource1">
        <ItemTemplate>
          <hr />
          <asp:Repeater 
            id="Repeater1" 
            runat="server" 
            DataSource='<%# XPathSelect("contact") %>' >
            <ItemTemplate>
              Name: <%# XPath("name") %> <br />
              Note: <%# XPath("note") %> <br />
              <hr />
            </ItemTemplate>
          </asp:Repeater>
        </ItemTemplate>
      </asp:FormView>
    </div>
    </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 id="Head1" runat="server">
    <title>TemplateControl XPath Example</title>
</head>
<body>
    <h3>TemplateControl XPath and XPathSelect Example</h3>
    <form id="form1" runat="server">
    <div>
      <asp:XmlDataSource
        id="XmlDataSource1" 
        runat="server"
        XPath="contacts" 
        DataFile="contacts.xml" />    
      <asp:FormView 
        id="FormView1" 
        runat="server" 
        DataSourceID="XmlDataSource1">
        <ItemTemplate>
          <hr />
          <asp:Repeater 
            id="Repeater1" 
            runat="server" 
            DataSource='<%# XPathSelect("contact") %>' >
            <ItemTemplate>
              Name: <%# XPath("name") %> <br />
              Note: <%# XPath("note") %> <br />
              <hr />
            </ItemTemplate>
          </asp:Repeater>
        </ItemTemplate>
      </asp:FormView>
    </div>
    </form>
</body>
</html>

Die folgenden XML-Testdaten können im vorherigen Codebeispiel verwendet werden.

<contacts>  
   <contact id="1">  
     <name>contact name 1</name>  
     <note>contact note 1</note>  
   </contact>  
   <contact id="2">  
     <name>contact name 2</name>  
     <note>contact note 2</note>  
   </contact>  
</contacts>

Hinweise

Die XPath Methode ruft die XPathBinder.Eval Methode mithilfe der GetDataItem Methode auf, um den Objektverweis zu beheben, für den IXPathNavigable der Ausdruck ausgewertet wird.

Siehe auch

Gilt für

XPath(String, String)

Wertet mithilfe der angegebenen Formatzeichenfolge einen XPath-Datenbindungsausdruck aus und zeigt das Ergebnis an.

protected public:
 System::String ^ XPath(System::String ^ xPathExpression, System::String ^ format);
protected internal string XPath (string xPathExpression, string format);
member this.XPath : string * string -> string
Protected Friend Function XPath (xPathExpression As String, format As String) As String

Parameter

xPathExpression
String

Der auszuwertende XPath-Ausdruck. Weitere Informationen finden Sie unter XPathBinder.

format
String

Eine für das Ergebnis geltende .NET Framework-Formatzeichenfolge.

Gibt zurück

String

Eine Zeichenfolge, die bei der Auswertung des Datenbindungsausdrucks und der Konvertierung in einen Zeichenfolgentyp entsteht.

Ausnahmen

InvalidOperationException

Die Datenbindungsmethode kann nur für in einer Page enthaltene Steuerelemente verwendet werden.

Hinweise

Die XPath Methode ruft die XPathBinder.Eval Methode mithilfe der GetDataItem Methode auf, um den Objektverweis zu beheben, für den IXPathNavigable der Ausdruck ausgewertet wird.

Siehe auch

Gilt für