XPathBinder.Eval Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Analiza y evalúa una expresión de enlace de datos XPath en un objeto IXPathNavigable en tiempo de ejecución.
Sobrecargas
Eval(Object, String) |
Evalúa las expresiones de enlace de datos XPath en tiempo de ejecución. |
Eval(Object, String, String) |
Evalúa las expresiones de enlace de datos XPath en tiempo de ejecución y da al resultado el formato del texto que se va a mostrar en el explorador que realiza la solicitud. |
Eval(Object, String, IXmlNamespaceResolver) |
Evalúa las expresiones de enlace de datos XPath en tiempo de ejecución y da al resultado el formato del texto que se va a mostrar en el explorador que realiza la solicitud, utilizando el objeto IXmlNamespaceResolver especificado para resolver los prefijos de espacio de nombres en la expresión XPath. |
Eval(Object, String, String, IXmlNamespaceResolver) |
Evalúa las expresiones de enlace de datos XPath en tiempo de ejecución y da al resultado el formato del texto que se va a mostrar en el explorador que realiza la solicitud, utilizando el objeto IXmlNamespaceResolver especificado para resolver los prefijos de espacio de nombres en la expresión XPath. |
Eval(Object, String)
Evalúa las expresiones de enlace de datos XPath en tiempo de ejecución.
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
Referencia del objeto IXPathNavigable con respecto a la que se evalúa la expresión. Éste debe ser un identificador del objeto válido en el lenguaje especificado de la página.
- xPath
- String
Consulta XPath de container
al valor de propiedad que se sitúa en la propiedad de control enlazado.
Devoluciones
Object resultante de la evaluación de la expresión de enlace de datos.
Excepciones
El parámetro container
o xpath
es null
.
El objeto especificado por container
no es un objeto IXPathNavigable.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar un XmlDataSource control con un control con Repeater plantilla para mostrar datos XML. Este ejemplo tiene dos partes:
Página Web Forms que muestra datos XML.
Un archivo XML que contiene los datos.
La primera parte del ejemplo muestra una página de Web Forms que muestra los datos XML a los que se accede a través de un XmlDataSource control . Un Repeater control usa la sintaxis del método simplificado Eval(Object, String) para enlazar a elementos de datos dentro del documento XML que XmlDataSource representa. Usa el Select(Object, String) método para recuperar una IEnumerable lista y asignarla como una propiedad enlazada DataSource en tiempo de ejecución para el Repeater control.
<%@ 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>
En el segundo ejemplo se proporciona el archivo XML, Bookstore2.xml, que se usa como origen de los datos mostrados en la página Web Forms definida anteriormente.
<?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>
Comentarios
Puede usar el Eval método mediante declaración si desea simplificar la conversión de un nodo XML en una cadena de texto que se va a mostrar en un explorador. Para ello, debe colocar las <%# and %> etiquetas, que también se usan en el enlace de datos estándar ASP.NET, en torno a la expresión de enlace de datos.
Para cualquiera de las listas ASP.NET controles de servidor, como DataList, DataGrido Repeater, el container
parámetro debe ser Container.DataItem
. Si va a enlazar con la página, el container
parámetro debe ser Page
.
Consulte también
Se aplica a
Eval(Object, String, String)
Evalúa las expresiones de enlace de datos XPath en tiempo de ejecución y da al resultado el formato del texto que se va a mostrar en el explorador que realiza la solicitud.
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
Referencia del objeto IXPathNavigable con respecto a la que se evalúa la expresión. Éste debe ser un identificador del objeto válido en el lenguaje especificado de la página.
- xPath
- String
Consulta XPath del container
al valor de propiedad que se va a situar en la propiedad de control enlazado.
- format
- String
Cadena de formato de .NET Framework, similar a las utilizadas por Format(String, Object), que convierte el objeto IXPathNavigable (resultante de la evaluación de la expresión de enlace de datos) en una String que el explorador que realiza la solicitud puede mostrar.
Devoluciones
String resultante de la evaluación de la expresión de enlace de datos y de la conversión a un tipo de cadena.
Excepciones
El parámetro container
o xpath
es null
.
El objeto especificado por container
no es IXPathNavigable.
Comentarios
Para obtener más información sobre las cadenas de formato en la .NET Framework, consulte Formato de tipos.
Puede usar el Eval(Object, String) método mediante declaración si desea simplificar la conversión de un nodo XML en una cadena de texto que se va a mostrar en un explorador. Para ello, debe colocar las <%# and %> etiquetas, que también se usan en el enlace de datos estándar ASP.NET, en torno a la expresión de enlace de datos.
Para cualquiera de las listas ASP.NET controles de servidor, como DataList, DataGrido Repeater, el container
parámetro debe ser Container.DataItem
. Si va a enlazar con la página, el container
parámetro debe ser Page
.
Consulte también
Se aplica a
Eval(Object, String, IXmlNamespaceResolver)
Evalúa las expresiones de enlace de datos XPath en tiempo de ejecución y da al resultado el formato del texto que se va a mostrar en el explorador que realiza la solicitud, utilizando el objeto IXmlNamespaceResolver especificado para resolver los prefijos de espacio de nombres en la expresión 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
Referencia del objeto IXPathNavigable con respecto a la que se evalúa la expresión. Éste debe ser un identificador del objeto válido en el lenguaje especificado de la página.
- xPath
- String
Consulta XPath del container
al valor de propiedad que se va a situar en la propiedad de control enlazado.
- resolver
- IXmlNamespaceResolver
Objeto IXmlNamespaceResolver usado para resolver los prefijos de espacio de nombres en la expresión XPath.
Devoluciones
Object resultante de la evaluación de la expresión de enlace de datos.
Comentarios
Puede usar el Eval método mediante declaración si desea simplificar la conversión de un nodo XML en una cadena de texto que se va a mostrar en un explorador. Para ello, debe colocar las <%# and %> etiquetas, que también se usan en el enlace de datos estándar ASP.NET, en torno a la expresión de enlace de datos. La expresión de enlace de datos incluye la expresión XPath y un IXmlNamespaceResolver objeto para resolver la referencia del espacio de nombres.
Para cualquiera de las listas ASP.NET controles de servidor, como DataList, DataGrido Repeater, el container
parámetro debe ser Container.DataItem
. Si va a enlazar con la página, el container
parámetro debe ser Page
.
Se aplica a
Eval(Object, String, String, IXmlNamespaceResolver)
Evalúa las expresiones de enlace de datos XPath en tiempo de ejecución y da al resultado el formato del texto que se va a mostrar en el explorador que realiza la solicitud, utilizando el objeto IXmlNamespaceResolver especificado para resolver los prefijos de espacio de nombres en la expresión XPath.
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
Referencia del objeto IXPathNavigable con respecto a la que se evalúa la expresión. Éste debe ser un identificador del objeto válido en el lenguaje especificado de la página.
- xPath
- String
Consulta XPath del container
al valor de propiedad que se va a situar en la propiedad de control enlazado.
- format
- String
Cadena de formato de .NET Framework, similar a las utilizadas por Format(String, Object), que convierte el objeto IXPathNavigable (resultante de la evaluación de la expresión de enlace de datos) en una String que el explorador que realiza la solicitud puede mostrar.
- resolver
- IXmlNamespaceResolver
Objeto IXmlNamespaceResolver usado para resolver los prefijos de espacio de nombres en la expresión XPath.
Devoluciones
String resultante de la evaluación de la expresión de enlace de datos y de la conversión a un tipo de cadena.
Comentarios
Puede usar el Eval método mediante declaración si desea simplificar la conversión de un nodo XML en una cadena de texto que se va a mostrar en un explorador. Para ello, debe colocar las <%# and %> etiquetas, que también se usan en el enlace de datos estándar ASP.NET, en torno a la expresión de enlace de datos. La expresión de enlace de datos incluye la expresión XPath y un IXmlNamespaceResolver objeto para resolver la referencia del espacio de nombres.
Para cualquiera de las listas ASP.NET controles de servidor, como DataList, DataGrido Repeater, el container
parámetro debe ser Container.DataItem
. Si va a enlazar con la página, el container
parámetro debe ser Page
.