TemplateControl.XPath Método

Definição

Espaço de Nomes:: System.Web.UI

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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

Sobrecargas

Name	Description
XPath(String, String, IXmlNamespaceResolver)	Avalia uma expressão de ligação de dados XPath usando o prefixo especificado e os mapeamentos do espaço de nomes para resolução do espaço de nomes e a string de formato especificada para mostrar o resultado.
XPath(String, IXmlNamespaceResolver)	Avalia uma expressão de ligação de dados XPath usando o prefixo especificado e os mapeamentos de namespace para resolução de namespace.
XPath(String)	Avalia uma expressão de ligação de dados XPath.
XPath(String, String)	Avalia uma expressão de ligação de dados XPath usando a string de formato especificada para mostrar o resultado.

XPath(String, String, IXmlNamespaceResolver)

Avalia uma expressão de ligação de dados XPath usando o prefixo especificado e os mapeamentos do espaço de nomes para resolução do espaço de nomes e a string de formato especificada para mostrar 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 para avaliar. Para obter mais informações, veja XPathBinder.

format: String

Uma string de formato .NET Framework para aplicar ao resultado.

resolver: IXmlNamespaceResolver

Um conjunto de mapeamentos de prefixos e namespace usados para resolução de namespace.

Devoluções

String

Uma cadeia que resulta da avaliação da expressão de ligação de dados e da conversão para um tipo de cadeia.

Exceções

InvalidOperationException

O método de ligação de dados pode ser usado apenas para controlos contidos num Page.

Observações

O XPath método chama o XPathBinder.Eval método que usa o GetDataItem método para resolver a IXPathNavigable referência do objeto contra a qual a expressão é avaliada.

Ver também

Aplica-se a

XPath(String, IXmlNamespaceResolver)

Avalia uma expressão de ligação de dados XPath usando o prefixo especificado e os mapeamentos de namespace para 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 para avaliar. Para obter mais informações, veja XPathBinder.

resolver: IXmlNamespaceResolver

Um conjunto de mapeamentos de prefixos e namespace usados para resolução de namespace.

Devoluções

Object

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

Exceções

InvalidOperationException

O método de ligação de dados pode ser usado apenas para controlos contidos num Page.

Observações

O XPath método chama o XPathBinder.Eval método que usa o GetDataItem método para resolver a IXPathNavigable referência do objeto contra a qual a expressão é avaliada.

Ver também

XPathBinder

Aplica-se a

XPath(String)

Avalia uma expressão de ligaçã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 para avaliar. Para obter mais informações, veja XPathBinder.

Devoluções

Object

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

Exceções

InvalidOperationException

O método de ligação de dados pode ser usado apenas para controlos contidos num Page.

Exemplos

O exemplo de código seguinte demonstra como usar o XPath método num Repeater controlo.

<%@ 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 seguintes dados XML de teste 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>

Observações

O XPath método chama o XPathBinder.Eval método que usa o GetDataItem método para resolver a IXPathNavigable referência do objeto contra a qual a expressão é avaliada.

Ver também

XPathBinder

Aplica-se a

XPath(String, String)

Avalia uma expressão de ligação de dados XPath usando a string de formato especificada para mostrar 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 para avaliar. Para obter mais informações, veja XPathBinder.

format: String

Uma string de formato .NET Framework para aplicar ao resultado.

Devoluções

String

Uma cadeia que resulta da avaliação da expressão de ligação de dados e da conversão para um tipo de cadeia.

Exceções

InvalidOperationException

O método de ligação de dados pode ser usado apenas para controlos contidos num Page.

Observações

O XPath método chama o XPathBinder.Eval método que usa o GetDataItem método para resolver a IXPathNavigable referência do objeto contra a qual a expressão é avaliada.

Ver também

Aplica-se a

Comentários

Esta página foi útil?