TemplateControl.XPath Methode

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.

Bietet Unterstützung zum Analysieren und Auswerten eines XPath-Datenbindungsausdrucks für ein Objekt zur Laufzeit.

Überlädt

Name	Beschreibung
XPath(String, String, IXmlNamespaceResolver)	Wertet einen XPath-Datenbindungsausdruck mithilfe der angegebenen Präfix- und Namespacezuordnungen für die Namespaceauflösung und die angegebene Formatzeichenfolge aus, um das Ergebnis anzuzeigen.
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 einen XPath-Datenbindungsausdruck mithilfe der angegebenen Formatzeichenfolge aus, um das Ergebnis anzuzeigen.

XPath(String, String, IXmlNamespaceResolver)

Wertet einen XPath-Datenbindungsausdruck mithilfe der angegebenen Präfix- und Namespacezuordnungen für die Namespaceauflösung und die angegebene Formatzeichenfolge aus, um das Ergebnis anzuzeigen.

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 .NET Framework-Formatzeichenfolge, die auf das Ergebnis angewendet werden soll.

resolver: IXmlNamespaceResolver

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

Gibt zurück

String

Eine Zeichenfolge, die aus der Auswertung des Datenbindungsausdrucks und der Konvertierung in einen Zeichenfolgentyp resultiert.

Ausnahmen

InvalidOperationException

Die Datenbindungsmethode kann nur für Steuerelemente verwendet werden, die in einem PageSteuerelement enthalten sind.

Hinweise

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

Weitere Informationen

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 Reihe von Präfix- und Namespacezuordnungen, die für die Namespaceauflösung verwendet werden.

Gibt zurück

Object

Ein Objekt, das aus der Auswertung des Datenbindungsausdrucks resultiert.

Ausnahmen

InvalidOperationException

Die Datenbindungsmethode kann nur für Steuerelemente verwendet werden, die in einem PageSteuerelement enthalten sind.

Hinweise

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

Weitere Informationen

XPathBinder

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 aus der Auswertung des Datenbindungsausdrucks resultiert.

Ausnahmen

InvalidOperationException

Die Datenbindungsmethode kann nur für Steuerelemente verwendet werden, die in einem PageSteuerelement enthalten sind.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der XPath Methode in einem Repeater Steuerelement veranschaulicht.

<%@ 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 Methode mithilfe der GetDataItem XPathBinder.Eval Methode auf, um den IXPathNavigable Objektverweis aufzulösen, für den der Ausdruck ausgewertet wird.

Weitere Informationen

XPathBinder

Gilt für:

XPath(String, String)

Wertet einen XPath-Datenbindungsausdruck mithilfe der angegebenen Formatzeichenfolge aus, um das Ergebnis anzuzeigen.

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 .NET Framework-Formatzeichenfolge, die auf das Ergebnis angewendet werden soll.

Gibt zurück

String

Eine Zeichenfolge, die aus der Auswertung des Datenbindungsausdrucks und der Konvertierung in einen Zeichenfolgentyp resultiert.

Ausnahmen

InvalidOperationException

Die Datenbindungsmethode kann nur für Steuerelemente verwendet werden, die in einem PageSteuerelement enthalten sind.

Hinweise

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

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?