XPathBinder.Eval 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.

Analisa e avalia uma expressão de associação de dados XPath em relação a um objeto IXPathNavigable no tempo de execução.

Sobrecargas

Eval(Object, String)	Avalia as expressões de associação de dados XPath no tempo de execução.
Eval(Object, String, String)	Avalia as expressões de associação de dados XPath no tempo de execução e formata o resultado como texto a ser exibido no navegador solicitante.
Eval(Object, String, IXmlNamespaceResolver)	Avalia as expressões de associação de dados XPath no tempo de execução e formata o resultado como texto a ser exibido no navegador solicitante usando o objeto IXmlNamespaceResolver especificado para resolver os prefixos de namespace na expressão XPath.
Eval(Object, String, String, IXmlNamespaceResolver)	Avalia as expressões de associação de dados XPath no tempo de execução e formata o resultado como texto a ser exibido no navegador solicitante usando o objeto IXmlNamespaceResolver especificado para resolver os prefixos de namespace na expressão XPath.

Eval(Object, String)

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

public:
 static System::Object ^ Eval(System::Object ^ container, System::String ^ xPath);

public static object Eval (object container, string xPath);

static member Eval : obj * string -> obj

Public Shared Function Eval (container As Object, xPath As String) As Object

Parâmetros

container: Object

A referência de objeto IXPathNavigable na qual a expressão é avaliada. Este valor deve ser um identificador de objeto válido no idioma especificado da página.

xPath: String

A consulta XPath do container para o valor da propriedade que é colocado na propriedade do controle associado.

Retornos

Object

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

Exceções

ArgumentNullException

O parâmetro container ou xpath é null.

ArgumentException

O objeto especificado por container não é um objeto IXPathNavigable.

Exemplos

O exemplo de código a seguir demonstra como usar um XmlDataSource controle com um controle com modelo Repeater para exibir dados XML. Este exemplo tem duas partes:

Uma página Web Forms que exibe dados XML.
Um arquivo XML que contém os dados.

A primeira parte do exemplo mostra uma página Web Forms que exibe dados XML acessados por meio de um XmlDataSource controle. Um Repeater controle usa a sintaxe do método simplificado Eval(Object, String) para associar a itens de dados dentro do documento XML que ele XmlDataSource representa. Ele usa o Select(Object, String) método para recuperar uma IEnumerable lista e atribuí-la como uma propriedade com limite DataSource tardio para o 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>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:XmlDataSource
        runat="server"
        id="XmlDataSource1"
        DataFile="bookstore2.xml"
        XPath="bookstore/genre[@name='fiction']" />

      <asp:Repeater
        runat="server"
        DataSourceID="XmlDataSource1">
        <ItemTemplate>
            <h1><%# XPath ("book/title") %></h1>
            <b>Author:</b>
            <%# XPath ("book/author/firstname") %>
            <%# XPath ("book/author/lastname") %>
            <asp:Repeater
                 DataSource='<%# XPathSelect ("book/chapters") %>'
                 runat="server">
                <ItemTemplate>
                     <%# XPath ("chapter/@name") %>
                </ItemTemplate>
            </asp:Repeater>
        </ItemTemplate>
    </asp:Repeater>
  </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 runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:XmlDataSource
        runat="server"
        id="XmlDataSource1"
        DataFile="bookstore2.xml"
        XPath="bookstore/genre[@name='fiction']" />

      <asp:Repeater
        runat="server"
        DataSourceID="XmlDataSource1">
        <ItemTemplate>
            <h1><%# XPath ("book/title") %></h1>
            <b>Author:</b>
            <%# XPath ("book/author/firstname") %>
            <%# XPath ("book/author/lastname") %>
            <asp:Repeater
                 DataSource='<%# XPathSelect ("book/chapters") %>'
                 runat="server">
                <ItemTemplate>
                     <%# XPath ("chapter/@name") %>
                </ItemTemplate>
            </asp:Repeater>
        </ItemTemplate>
    </asp:Repeater>
  </form>
  </body>
</html>

O segundo exemplo fornece o arquivo XML, Bookstore2.xml, que é usado como a fonte dos dados exibidos na página Web Forms definida acima.

<?xml version="1.0" encoding="iso-8859-1"?>  
  <bookstore>  
    <genre name="fiction">  
      <book ISBN="10-861003-324">  
        <author>  
          <firstname>test</firstname>  
          <lastname>test2</lastname>  
        </author>  
        <title>The Handmaid's Tale</title>  
        <price>12.95</price>  
        <chapters>  
          <chapter num="1" name="Introduction" />   
          <chapter num="2" name="Body" />   
          <chapter num="3" name="Conclusion" />  
        </chapters>  
      </book>  
    </genre>  
    <genre name="nonfiction">  
      <book genre="nonfiction" ISBN="1-861001-57-5">  
        <author>  
          <firstname>test3</firstname>  
          <lastname>test4</lastname>  
        </author>      
        <title>Pride And Prejudice</title>  
        <price>24.95</price>  
        <chapters>  
          <chapter num="1" name="Introduction" />   
          <chapter num="2" name="Body" />  
          <chapter num="3" name="Conclusion" />  
        </chapters>  
      </book>  
    </genre>  
  </bookstore>

Comentários

Você pode usar o Eval método declarativamente se quiser simplificar a conversão de um nó XML em uma cadeia de caracteres de texto a ser exibida em um navegador. Para fazer isso, você deve colocar as <%# and %> marcas, que também são usadas na associação de dados padrão ASP.NET, em torno da expressão de associação de dados.

Para qualquer uma das listas ASP.NET controles de servidor, comoDataList, DataGridouRepeater, o container parâmetro deve ser Container.DataItem. Se você estiver associando à página, o container parâmetro deverá ser Page.

Confira também

Aplica-se a

Eval(Object, String, String)

Avalia as expressões de associação de dados XPath no tempo de execução e formata o resultado como texto a ser exibido no navegador solicitante.

public:
 static System::String ^ Eval(System::Object ^ container, System::String ^ xPath, System::String ^ format);

public static string Eval (object container, string xPath, string format);

static member Eval : obj * string * string -> string

Public Shared Function Eval (container As Object, xPath As String, format As String) As String

Parâmetros

container: Object

A referência de objeto IXPathNavigable na qual a expressão é avaliada. Este valor deve ser um identificador de objeto válido no idioma especificado da página.

xPath: String

A consulta XPath do container para o valor da propriedade a ser colocado na propriedade de controle associado.

format: String

Uma cadeia de caracteres no formato do .NET Framework, semelhante àquelas usadas pelo Format(String, Object), que converte o objeto IXPathNavigable (proveniente da avaliação da expressão de associação de dados) em um String que pode ser exibido pelo navegador solicitante.

Retornos

String

Um String resultante da avaliação da expressão de associação de dados e da conversão em um tipo de cadeia de caracteres.

Exceções

ArgumentNullException

O parâmetro container ou xpath é null.

ArgumentException

O objeto especificado pelo container não é um IXPathNavigable.

Comentários

Para saber mais sobre como formatar cadeias de caracteres no .NET Framework, consulte Tipos de Formatação.

Você pode usar o Eval(Object, String) método declarativamente se quiser simplificar a conversão de um nó XML em uma cadeia de caracteres de texto a ser exibida em um navegador. Para fazer isso, você deve colocar as <%# and %> marcas, que também são usadas na associação de dados padrão ASP.NET, em torno da expressão de associação de dados.

Confira também

Tipos de formatação no .NET

Aplica-se a

Eval(Object, String, IXmlNamespaceResolver)

Avalia as expressões de associação de dados XPath no tempo de execução e formata o resultado como texto a ser exibido no navegador solicitante usando o objeto IXmlNamespaceResolver especificado para resolver os prefixos de namespace na expressão XPath.

public:
 static System::Object ^ Eval(System::Object ^ container, System::String ^ xPath, System::Xml::IXmlNamespaceResolver ^ resolver);

public static object Eval (object container, string xPath, System.Xml.IXmlNamespaceResolver resolver);

static member Eval : obj * string * System.Xml.IXmlNamespaceResolver -> obj

Public Shared Function Eval (container As Object, xPath As String, resolver As IXmlNamespaceResolver) As Object

Parâmetros

container: Object

A referência de objeto IXPathNavigable na qual a expressão é avaliada. Este valor deve ser um identificador de objeto válido no idioma especificado da página.

xPath: String

A consulta XPath do container para o valor da propriedade a ser colocado na propriedade de controle associado.

resolver: IXmlNamespaceResolver

O objeto IXmlNamespaceResolver usado para resolver os prefixos de namespace na expressão XPath.

Retornos

Object

Um Object resultante da avaliação da expressão de associação de dados.

Comentários

Aplica-se a

Eval(Object, String, String, IXmlNamespaceResolver)

public:
 static System::String ^ Eval(System::Object ^ container, System::String ^ xPath, System::String ^ format, System::Xml::IXmlNamespaceResolver ^ resolver);

public static string Eval (object container, string xPath, string format, System.Xml.IXmlNamespaceResolver resolver);

static member Eval : obj * string * string * System.Xml.IXmlNamespaceResolver -> string

Public Shared Function Eval (container As Object, xPath As String, format As String, resolver As IXmlNamespaceResolver) As String

Parâmetros

container: Object

A referência de objeto IXPathNavigable na qual a expressão é avaliada. Este valor deve ser um identificador de objeto válido no idioma especificado da página.

xPath: String

A consulta XPath do container para o valor da propriedade a ser colocado na propriedade de controle associado.

format: String

resolver: IXmlNamespaceResolver

O objeto IXmlNamespaceResolver usado para resolver os prefixos de namespace na expressão XPath.

Retornos

String

Um String resultante da avaliação da expressão de associação de dados e da conversão em um tipo de cadeia de caracteres.

Comentários

Aplica-se a

Compartilhar via

XPathBinder.Eval Método

Definição

Sobrecargas

Eval(Object, String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Eval(Object, String, String)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

Eval(Object, String, IXmlNamespaceResolver)

Parâmetros

Retornos

Comentários

Aplica-se a

Eval(Object, String, String, IXmlNamespaceResolver)

Parâmetros

Retornos

Comentários

Aplica-se a

Recursos adicionais