Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais
Cette documentation est archivée et n’est pas conservée.

DataBinder.Eval, méthode (Object, String, String)

Évalue les expressions de liaison aux données au moment de l'exécution et met en forme le résultat sous forme de chaîne.

Espace de noms :  System.Web.UI
Assembly :  System.Web (dans System.Web.dll)

public static string Eval(
	Object container,
	string expression,
	string format
)

Paramètres

container
Type : System.Object
Référence d'objet 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.
expression
Type : System.String
Chemin de navigation à partir de l'objet container jusqu'à la valeur de propriété à placer dans la propriété du contrôle lié. Il doit s'agir d'une propriété de type chaîne ou de noms de champs séparés par des points, par exemple Tables[0].DefaultView.[0].Price en C# ou Tables(0).DefaultView.(0).Price en Visual Basic.
format
Type : System.String
Chaîne de format .NET Framework (comme celles utilisées par String.Format) qui convertit l'instance de Object retournée par l'expression de liaison aux données à un objet String.

Valeur de retour

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

expression doit avoir pour valeur une propriété publique.

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

Cette méthode est appelée automatiquement lorsque vous créez des liaisons aux données dans un concepteur de développement rapide d'application (RAD, Rapid Application Development) tel que Visual Studio. Vous pouvez également l'utiliser de façon déclarative pour convertir le Object qui résulte de l'expression de liaison aux données en String. Pour vous servir de la méthode de façon déclarative, utilisez la syntaxe d'expression <%#   %>, telle qu'elle est utilisée dans la liaison aux données ASP.NET standard.

Cette méthode s'avère particulièrement utile lorsque des données sont liées à des contrôles qui sont répertoriés dans une liste basée sur un modèle.

RemarqueRemarque

Comme cette méthode s'exécute à l'aide de l'évaluation à liaison tardive au moment de l'exécution, elle peut affecter sensiblement les performances par rapport à la syntaxe de liaison de données ASP.NET standard. Il est donc important de l'employer de manière judicieuse, en particulier lorsque la mise en forme de chaîne n'est pas requise.

Pour n'importe lequel des contrôles Web de la liste, notamment GridView, DetailsView, DataList ou Repeater, container doit être Container.DataItem. Si vous exécutez une liaison à la page, container doit avoir la valeur Page.

L'exemple de code suivant montre comment utiliser la méthode Eval de manière déclarative pour établir une liaison à un champ Price. Cet exemple utilise la syntaxe du conteneur qui suppose que vous utilisez l'un des contrôles serveur Web de la liste. Le paramètre format contient une expression qui met en forme le nombre en tant que valeur de type monétaire spécifique à un pays.


<%# DataBinder.Eval(Container.DataItem, "Price", "{0:c}") %>


.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Afficher: