Partilhar via


TemplateControl.XPath Método

Definição

Fornece suporte para análise e avaliação de uma expressão de associação de dados XPath em relação a um objeto em tempo de execução.

Sobrecargas

XPath(String, String, IXmlNamespaceResolver)

Avalia uma expressão de associação de dados XPath usando os mapeamentos de prefixo e namespace especificados para a resolução de namespace e a cadeia de caracteres de formato especificada para exibir o resultado.

XPath(String, IXmlNamespaceResolver)

Avalia uma expressão de associação de dados XPath usando os mapeamentos de namespace e prefixo especificados para a resolução de namespace.

XPath(String)

Avalia as expressões de associação de dados XPath.

XPath(String, String)

Avalia uma expressão de associação de dados XPath usando a cadeia de caracteres de formato especificada para exibir o resultado.

XPath(String, String, IXmlNamespaceResolver)

Avalia uma expressão de associação de dados XPath usando os mapeamentos de prefixo e namespace especificados para a resolução de namespace e a cadeia de caracteres de formato especificada para exibir o resultado.

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

Parâmetros

xPathExpression
String

A expressão XPath a ser avaliada. Para obter mais informações, consulte XPathBinder.

format
String

Uma cadeia de formato do .NET Framework para aplicar ao resultado.

resolver
IXmlNamespaceResolver

Um conjunto de mapeamentos de prefixo e namespace usado para resolução de namespace.

Retornos

String

Uma cadeia de caracteres que resulta da avaliação da expressão e conversão da associação de dados em um tipo de cadeia de caracteres.

Exceções

O método de associação de dados pode ser usado somente para controles contidos em um Page.

Comentários

O XPath método chama o XPathBinder.Eval método usando o GetDataItem método para resolver a referência de IXPathNavigable objeto na qual a expressão é avaliada.

Confira também

Aplica-se a

XPath(String, IXmlNamespaceResolver)

Avalia uma expressão de associação de dados XPath usando os mapeamentos de namespace e prefixo especificados para a resolução de namespace.

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

Parâmetros

xPathExpression
String

A expressão XPath a ser avaliada. Para obter mais informações, consulte XPathBinder.

resolver
IXmlNamespaceResolver

Um conjunto de mapeamentos de prefixo e namespace usado para resolução de namespace.

Retornos

Object

Um objeto que resulta da avaliação da expressão de associação de dados.

Exceções

O método de associação de dados pode ser usado somente para controles contidos em um Page.

Comentários

O XPath método chama o XPathBinder.Eval método usando o GetDataItem método para resolver a referência de IXPathNavigable objeto na qual a expressão é avaliada.

Confira também

Aplica-se a

XPath(String)

Avalia as expressões de associação de dados 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

Parâmetros

xPathExpression
String

A expressão XPath a ser avaliada. Para obter mais informações, consulte XPathBinder.

Retornos

Object

Um objeto que resulta da avaliação da expressão de associação de dados.

Exceções

O método de associação de dados pode ser usado somente para controles contidos em um Page.

Exemplos

O exemplo de código a seguir demonstra como usar o XPath método em um Repeater controle.

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

Os dados XML de teste a seguir podem ser usados no exemplo de código anterior.

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

Comentários

O XPath método chama o XPathBinder.Eval método usando o GetDataItem método para resolver a referência de IXPathNavigable objeto na qual a expressão é avaliada.

Confira também

Aplica-se a

XPath(String, String)

Avalia uma expressão de associação de dados XPath usando a cadeia de caracteres de formato especificada para exibir o resultado.

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

Parâmetros

xPathExpression
String

A expressão XPath a ser avaliada. Para obter mais informações, consulte XPathBinder.

format
String

Uma cadeia de formato do .NET Framework para aplicar ao resultado.

Retornos

String

Uma cadeia de caracteres que resulta da avaliação da expressão e conversão da associação de dados em um tipo de cadeia de caracteres.

Exceções

O método de associação de dados pode ser usado somente para controles contidos em um Page.

Comentários

O XPath método chama o XPathBinder.Eval método usando o GetDataItem método para resolver a referência de IXPathNavigable objeto na qual a expressão é avaliada.

Confira também

Aplica-se a