TemplateControl.XPath TemplateControl.XPath TemplateControl.XPath TemplateControl.XPath Method

Definition

Bietet Unterstützung für die Analyse und Auswertung eines XPath-Datenbindungsausdrucks anhand eines Objekts zur Laufzeit.Provides support for parsing and evaluating an XPath data-binding expression against an object at run time.

Überlädt

XPath(String, String, IXmlNamespaceResolver) XPath(String, String, IXmlNamespaceResolver) XPath(String, String, IXmlNamespaceResolver) 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.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution and the specified format string to display the result.

XPath(String, IXmlNamespaceResolver) XPath(String, IXmlNamespaceResolver) XPath(String, IXmlNamespaceResolver) XPath(String, IXmlNamespaceResolver)

Wertet einen XPath-Datenbindungsausdruck mithilfe der angegebenen Präfix- und Namespacezuordnungen für die Namespaceauflösung aus.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution.

XPath(String) XPath(String) XPath(String) XPath(String)

Wertet einen XPath-Datenbindungsausdruck aus.Evaluates an XPath data-binding expression.

XPath(String, String) XPath(String, String) XPath(String, String) XPath(String, String)

Wertet mithilfe der angegebenen Formatzeichenfolge einen XPath-Datenbindungsausdruck aus und zeigt das Ergebnis an.Evaluates an XPath data-binding expression using the specified format string to display the result.

XPath(String, String, IXmlNamespaceResolver) XPath(String, String, IXmlNamespaceResolver) XPath(String, String, IXmlNamespaceResolver) 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.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution and the specified format string to display the result.

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 String String String

Der auszuwertende XPath-Ausdruck.The XPath expression to evaluate. Weitere Informationen finden Sie unter XPathBinder.For more information, see XPathBinder.

format
String String String String

Eine für das Ergebnis geltende .NET Framework-Formatzeichenfolge.A .NET Framework format string to apply to the result.

resolver
IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver

Eine Gruppe von Präfix- und Namespacezuordnungen, die für die Namespaceauflösung verwendet werden.A set of prefix and namespace mappings used for namespace resolution.

Gibt zurück

Eine Zeichenfolge, die bei der Auswertung des Datenbindungsausdrucks und der Konvertierung in einen Zeichenfolgentyp entsteht.A string that results from the evaluation of the data-binding expression and conversion to a string type.

Ausnahmen

Die Datenbindungsmethode kann nur für in einer Page enthaltene Steuerelemente verwendet werden.The data-binding method can be used only for controls contained on a Page.

Hinweise

Die XPath -Methode ruft XPathBinder.Eval die-Methode GetDataItem mithilfe der-Methode IXPathNavigable auf, um den Objekt Verweis aufzulösen, gegen den der Ausdruck ausgewertet wird.The XPath method calls the XPathBinder.Eval method using the GetDataItem method to resolve the IXPathNavigable object reference that the expression is evaluated against.

Siehe auch

XPath(String, IXmlNamespaceResolver) XPath(String, IXmlNamespaceResolver) XPath(String, IXmlNamespaceResolver) XPath(String, IXmlNamespaceResolver)

Wertet einen XPath-Datenbindungsausdruck mithilfe der angegebenen Präfix- und Namespacezuordnungen für die Namespaceauflösung aus.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution.

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 String String String

Der auszuwertende XPath-Ausdruck.The XPath expression to evaluate. Weitere Informationen finden Sie unter XPathBinder.For more information, see XPathBinder.

resolver
IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver

Eine Gruppe von Präfix- und Namespacezuordnungen, die für die Namespaceauflösung verwendet werden.A set of prefix and namespace mappings used for namespace resolution.

Gibt zurück

Ein Objekt, das bei der Auswertung des Datenbindungsausdrucks entstehtAn object that results from the evaluation of the data-binding expression.

Ausnahmen

Die Datenbindungsmethode kann nur für in einer Page enthaltene Steuerelemente verwendet werden.The data-binding method can be used only for controls contained on a Page.

Hinweise

Die XPath -Methode ruft XPathBinder.Eval die-Methode GetDataItem mithilfe der-Methode IXPathNavigable auf, um den Objekt Verweis aufzulösen, gegen den der Ausdruck ausgewertet wird.The XPath method calls the XPathBinder.Eval method using the GetDataItem method to resolve the IXPathNavigable object reference that the expression is evaluated against.

Siehe auch

XPath(String) XPath(String) XPath(String) XPath(String)

Wertet einen XPath-Datenbindungsausdruck aus.Evaluates an XPath data-binding expression.

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 String String String

Der auszuwertende XPath-Ausdruck.The XPath expression to evaluate. Weitere Informationen finden Sie unter XPathBinder.For more information, see XPathBinder.

Gibt zurück

Ein Objekt, das bei der Auswertung des Datenbindungsausdrucks entstehtAn object that results from the evaluation of the data-binding expression.

Ausnahmen

Die Datenbindungsmethode kann nur für in einer Page enthaltene Steuerelemente verwendet werden.The data-binding method can be used only for controls contained on a Page.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die XPath -Methode in Repeater einem-Steuerelement verwendet wird.The following code example demonstrates how to use the XPath method in a Repeater control.

<%@ 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-Test Daten können im vorangehenden Codebeispiel verwendet werden.The following test XML data can be used in the preceding code example.

<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 XPathBinder.Eval die-Methode GetDataItem mithilfe der-Methode IXPathNavigable auf, um den Objekt Verweis aufzulösen, gegen den der Ausdruck ausgewertet wird.The XPath method calls the XPathBinder.Eval method using the GetDataItem method to resolve the IXPathNavigable object reference that the expression is evaluated against.

Siehe auch

XPath(String, String) XPath(String, String) XPath(String, String) XPath(String, String)

Wertet mithilfe der angegebenen Formatzeichenfolge einen XPath-Datenbindungsausdruck aus und zeigt das Ergebnis an.Evaluates an XPath data-binding expression using the specified format string to display the result.

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 String String String

Der auszuwertende XPath-Ausdruck.The XPath expression to evaluate. Weitere Informationen finden Sie unter XPathBinder.For more information, see XPathBinder.

format
String String String String

Eine für das Ergebnis geltende .NET Framework-Formatzeichenfolge.A .NET Framework format string to apply to the result.

Gibt zurück

Eine Zeichenfolge, die bei der Auswertung des Datenbindungsausdrucks und der Konvertierung in einen Zeichenfolgentyp entsteht.A string that results from the evaluation of the data-binding expression and conversion to a string type.

Ausnahmen

Die Datenbindungsmethode kann nur für in einer Page enthaltene Steuerelemente verwendet werden.The data-binding method can be used only for controls contained on a Page.

Hinweise

Die XPath -Methode ruft XPathBinder.Eval die-Methode GetDataItem mithilfe der-Methode IXPathNavigable auf, um den Objekt Verweis aufzulösen, gegen den der Ausdruck ausgewertet wird.The XPath method calls the XPathBinder.Eval method using the GetDataItem method to resolve the IXPathNavigable object reference that the expression is evaluated against.

Siehe auch

Gilt für: