Partager via


TemplateControl.XPath Méthode

Définition

Fournit une prise en charge de l'analyse et de l'évaluation d'une expression de liaison de données XPath par rapport à un objet au moment de l'exécution.

Surcharges

XPath(String, String, IXmlNamespaceResolver)

Évalue une expression de liaison de données XPath à l'aide des mappages de préfixes et d'espaces de noms spécifiés pour la résolution d'espaces de noms, et de la chaîne de format spécifiée pour afficher le résultat.

XPath(String, IXmlNamespaceResolver)

Évalue une expression de liaison de données XPath à l'aide des mappages de préfixes et d'espaces de noms spécifiés pour la résolution d'espaces de noms.

XPath(String)

Évalue une expression de liaison de données XPath.

XPath(String, String)

Évalue une expression de liaison de données XPath à l'aide de la chaîne de format spécifiée pour afficher le résultat.

XPath(String, String, IXmlNamespaceResolver)

Évalue une expression de liaison de données XPath à l'aide des mappages de préfixes et d'espaces de noms spécifiés pour la résolution d'espaces de noms, et de la chaîne de format spécifiée pour afficher le résultat.

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

Paramètres

xPathExpression
String

Expression XPath à évaluer. Pour plus d'informations, consultez XPathBinder.

format
String

Chaîne de format .NET Framework à appliquer au résultat.

resolver
IXmlNamespaceResolver

Jeu de mappages de préfixes et d'espaces de noms utilisé pour la résolution d'espaces de noms.

Retours

String

Chaîne qui résulte de l'évaluation de l'expression de liaison de données et de sa conversion en un type chaîne.

Exceptions

La méthode de liaison de données peut être utilisée uniquement pour des contrôles contenus sur Page.

Remarques

La XPath méthode appelle la XPathBinder.Eval méthode à l’aide de la GetDataItem méthode pour résoudre la IXPathNavigable référence d’objet par rapport à laquelle l’expression est évaluée.

Voir aussi

S’applique à

XPath(String, IXmlNamespaceResolver)

Évalue une expression de liaison de données XPath à l'aide des mappages de préfixes et d'espaces de noms spécifiés pour la résolution d'espaces de noms.

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

Paramètres

xPathExpression
String

Expression XPath à évaluer. Pour plus d'informations, consultez XPathBinder.

resolver
IXmlNamespaceResolver

Jeu de mappages de préfixes et d'espaces de noms utilisé pour la résolution d'espaces de noms.

Retours

Object

Objet qui résulte de l'évaluation de l'expression de liaison de données.

Exceptions

La méthode de liaison de données peut être utilisée uniquement pour des contrôles contenus sur Page.

Remarques

La XPath méthode appelle la XPathBinder.Eval méthode à l’aide de la GetDataItem méthode pour résoudre la IXPathNavigable référence d’objet par rapport à laquelle l’expression est évaluée.

Voir aussi

S’applique à

XPath(String)

Évalue une expression de liaison de données XPath.

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

Paramètres

xPathExpression
String

Expression XPath à évaluer. Pour plus d'informations, consultez XPathBinder.

Retours

Object

Objet qui résulte de l'évaluation de l'expression de liaison de données.

Exceptions

La méthode de liaison de données peut être utilisée uniquement pour des contrôles contenus sur Page.

Exemples

L’exemple de code suivant montre comment utiliser la XPath méthode dans un Repeater contrôle.

<%@ 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>

Les données XML de test suivantes peuvent être utilisées dans l’exemple de code précédent.

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

Remarques

La XPath méthode appelle la XPathBinder.Eval méthode à l’aide de la GetDataItem méthode pour résoudre la IXPathNavigable référence d’objet par rapport à laquelle l’expression est évaluée.

Voir aussi

S’applique à

XPath(String, String)

Évalue une expression de liaison de données XPath à l'aide de la chaîne de format spécifiée pour afficher le résultat.

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

Paramètres

xPathExpression
String

Expression XPath à évaluer. Pour plus d'informations, consultez XPathBinder.

format
String

Chaîne de format .NET Framework à appliquer au résultat.

Retours

String

Chaîne qui résulte de l'évaluation de l'expression de liaison de données et de sa conversion en un type chaîne.

Exceptions

La méthode de liaison de données peut être utilisée uniquement pour des contrôles contenus sur Page.

Remarques

La XPath méthode appelle la XPathBinder.Eval méthode à l’aide de la GetDataItem méthode pour résoudre la IXPathNavigable référence d’objet par rapport à laquelle l’expression est évaluée.

Voir aussi

S’applique à