XPathBinder.Eval Méthode

Référence

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Analyse et évalue une expression de liaison de données XPath par rapport à un objet IXPathNavigable au moment de l'exécution.

Surcharges

Eval(Object, String)	Évalue des expressions de liaison de données XPath au moment de l'exécution.
Eval(Object, String, String)	Évalue des expressions de liaison de données XPath au moment de l'exécution et met le résultat sous forme de texte à afficher dans le navigateur demandeur.
Eval(Object, String, IXmlNamespaceResolver)	Évalue les expressions de liaison de données XPath au moment de l'exécution et met en forme le résultat sous forme de texte à afficher dans le navigateur demandeur, en utilisant l'objet IXmlNamespaceResolver spécifié pour résoudre des préfixes d'espace de noms dans l'expression XPath.
Eval(Object, String, String, IXmlNamespaceResolver)	Évalue les expressions de liaison de données XPath au moment de l'exécution et met en forme le résultat sous forme de texte à afficher dans le navigateur demandeur, en utilisant l'objet IXmlNamespaceResolver spécifié pour résoudre des préfixes d'espace de noms dans l'expression XPath.

Eval(Object, String)

Évalue des expressions de liaison de données XPath au moment de l'exécution.

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

Paramètres

container: Object

Référence de l'objet IXPathNavigable par rapport à laquelle l'expression est évaluée. Il doit s'agir d'un identificateur d'objet valide dans la langue spécifiée de la page.

xPath: String

Requête XPath provenant de container et allant jusqu'à la valeur de propriété placée dans la propriété du contrôle lié.

Retours

Object

Object qui résulte de l'évaluation de l'expression de liaison de données.

Exceptions

ArgumentNullException

Le paramètre container ou xpath est null.

ArgumentException

L'objet spécifié par container n'est pas un objet IXPathNavigable.

Exemples

L’exemple de code suivant montre comment utiliser un XmlDataSource contrôle avec un contrôle avec Repeater un modèle pour afficher des données XML. Cet exemple comporte deux parties :

Page Web Forms qui affiche des données XML.
Fichier XML qui contient les données.

La première partie de l’exemple montre une page Web Forms qui affiche les données XML accessibles via un XmlDataSource contrôle. Un Repeater contrôle utilise la syntaxe de méthode simplifiée Eval(Object, String) pour lier des éléments de données dans le document XML que représente XmlDataSource . Il utilise la Select(Object, String) méthode pour récupérer une IEnumerable liste et l’affecter en tant que propriété à liaison tardive DataSource pour le Repeater contrôle.

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

Le deuxième exemple fournit le fichier XML, Bookstore2.xml, qui est utilisé comme source des données affichées dans la page Web Forms définie ci-dessus.

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

Remarques

Vous pouvez utiliser la Eval méthode de manière déclarative si vous souhaitez simplifier le cast d’un nœud XML en chaîne de texte à afficher dans un navigateur. Pour ce faire, vous devez placer les <balises %# et %> , qui sont également utilisées dans la liaison de données ASP.NET standard, autour de l’expression de liaison de données.

Pour l’un des contrôles serveur ASP.NET liste, tels que DataList, DataGridou Repeater, le container paramètre doit être Container.DataItem. Si vous effectuez une liaison avec la page, le container paramètre doit être Page.

Voir aussi

S’applique à

Eval(Object, String, String)

Évalue des expressions de liaison de données XPath au moment de l'exécution et met le résultat sous forme de texte à afficher dans le navigateur demandeur.

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

Paramètres

container: Object

Référence de l'objet IXPathNavigable par rapport à laquelle l'expression est évaluée. Il doit s'agir d'un identificateur d'objet valide dans la langue spécifiée de la page.

xPath: String

Requête XPath à partir de container jusqu'à la valeur de propriété à placer dans la propriété du contrôle lié.

format: String

Chaîne de format .NET Framework, semblable à celle utilisée par Format(String, Object), qui convertit l'objet IXPathNavigable (résultant de l'évaluation de l'expression de liaison de données) en String affichable par le navigateur demandeur.

Retours

String

String qui résulte de l'évaluation de l'expression de liaison de données et de sa conversion en un type chaîne.

Exceptions

ArgumentNullException

Le paramètre container ou xpath est null.

ArgumentException

L'objet spécifié par container n'est pas un objet IXPathNavigable.

Remarques

Pour en savoir plus sur les chaînes de format dans le .NET Framework, consultez Mise en forme des types.

Vous pouvez utiliser la Eval(Object, String) méthode de manière déclarative si vous souhaitez simplifier le cast d’un nœud XML en chaîne de texte à afficher dans un navigateur. Pour ce faire, vous devez placer les <balises %# et %> , qui sont également utilisées dans la liaison de données ASP.NET standard, autour de l’expression de liaison de données.

Voir aussi

Mettre en forme des types dans .NET

S’applique à

Eval(Object, String, IXmlNamespaceResolver)

Évalue les expressions de liaison de données XPath au moment de l'exécution et met en forme le résultat sous forme de texte à afficher dans le navigateur demandeur, en utilisant l'objet IXmlNamespaceResolver spécifié pour résoudre des préfixes d'espace de noms dans l'expression 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

Paramètres

container: Object

Référence de l'objet IXPathNavigable par rapport à laquelle l'expression est évaluée. Il doit s'agir d'un identificateur d'objet valide dans la langue spécifiée de la page.

xPath: String

Requête XPath à partir de container jusqu'à la valeur de propriété à placer dans la propriété du contrôle lié.

resolver: IXmlNamespaceResolver

Objet IXmlNamespaceResolver permettant de trouver les préfixes d’espace de noms dans l’expression XPath.

Retours

Object

Object qui résulte de l'évaluation de l'expression de liaison de données.

Remarques

S’applique à

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

Paramètres

container: Object

Référence de l'objet IXPathNavigable par rapport à laquelle l'expression est évaluée. Il doit s'agir d'un identificateur d'objet valide dans la langue spécifiée de la page.

xPath: String

Requête XPath à partir de container jusqu'à la valeur de propriété à placer dans la propriété du contrôle lié.

format: String

resolver: IXmlNamespaceResolver

Objet IXmlNamespaceResolver permettant de trouver les préfixes d’espace de noms dans l’expression XPath.

Retours

String

String qui résulte de l'évaluation de l'expression de liaison de données et de sa conversion en un type chaîne.

Remarques

S’applique à

XPathBinder.Eval Méthode

Définition

Surcharges

Eval(Object, String)

Paramètres

Retours

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Eval(Object, String, String)

Paramètres

Retours

Exceptions

Remarques

Voir aussi

S’applique à

Eval(Object, String, IXmlNamespaceResolver)

Paramètres

Retours

Remarques

S’applique à

Eval(Object, String, String, IXmlNamespaceResolver)

Paramètres

Retours

Remarques

S’applique à

Commentaires

Ressources supplémentaires