TemplateControl.XPath Método

Referência

Definição

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

InvalidOperationException

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

InvalidOperationException

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

XPathBinder

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

InvalidOperationException

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

XPathBinder

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

InvalidOperationException

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

Partilhar via

TemplateControl.XPath Método

Definição

Sobrecargas

XPath(String, String, IXmlNamespaceResolver)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

XPath(String, IXmlNamespaceResolver)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

XPath(String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

XPath(String, String)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

Recursos adicionais