Cette documentation est archivée et n’est pas conservée.

ListControl.DataTextFormatString, propriété

Obtient ou définit la chaîne de mise en forme permettant de contrôler l'affichage des données liées au contrôle de liste.

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

[ThemeableAttribute(false)] 
public virtual string DataTextFormatString { get; set; }
/** @property */
public String get_DataTextFormatString ()

/** @property */
public void set_DataTextFormatString (String value)

public function get DataTextFormatString () : String

public function set DataTextFormatString (value : String)

Valeur de la propriété

Chaîne de mise en forme des données liées au contrôle. La valeur par défaut est String.Empty.

Utilisez la propriété DataTextFormatString pour proposer un format d'affichage personnalisé des éléments contenus dans un contrôle de liste.

Composée de deux parties séparées par le signe deux-points, la chaîne de format de données se présente comme suit : {A : Bxx}. Par exemple, la chaîne de mise en forme {0:F2} met en forme la cellule pour afficher un nombre à virgule fixe avec deux décimales.

RemarqueRemarque

La chaîne doit être entre accolades pour indiquer qu'il s'agit d'une chaîne de format et non d'une chaîne littérale. Tout texte figurant en dehors des accolades sera affiché en tant que texte littéral.

La valeur placée devant le signe deux-points (A dans l'exemple général) spécifie l'index du paramètre dans une liste de paramètres de base zéro.

RemarqueRemarque

Cette valeur ne peut être que 0, car il n'y a qu'une seule valeur dans chaque cellule.

Le caractère placé après le signe deux-points (B dans l'exemple général) spécifie le format dans lequel la valeur doit être affichée. Le tableau suivant répertorie les formats courants.

Caractère de format

Description

C

Affiche les valeurs numériques au format monétaire.

D

Affiche les valeurs numériques au format décimal.

E

Affiche les valeurs numériques au format scientifique (exponentiel).

F

Affiche les valeurs numériques au format fixe.

G

Affiche les valeurs numériques au format général.

N

Affiche les valeurs numériques au format numérique.

X

Affiche les valeurs numériques au format hexadécimal.

RemarqueRemarque

Le caractère de format ne respecte pas la casse, à l'exception de X qui affiche les caractères hexadécimaux dans la casse spécifiée.

La valeur placée après le caractère de format (xx dans l'exemple général) spécifie le nombre de chiffres significatifs ou de décimales à afficher.

Le tableau suivant comporte des exemples de chaînes de mise en forme et leurs résultats. Des paramètres standard français y sont utilisés.

Valeur numérique

Chaîne de format

Résultat

12345.6789

"{0:C}"

$12,345.68

-12345.6789

"{0:C}"

($12,345.68)

12345

"{0:D}"

12345

12345

"{0:D8}"

00012345

12345.6789

"{0:E}"

1234568E+004

12345.6789

"{0:E10}"

1,2345678900E+004

12345.6789

"{0:F}"

12345.68

12345.6789

"{0:F0}"

12346

12345.6789

"{0:G}"

12345.6789

123456789

"{0:G7}"

1,234568E8

12345.6789

"{0:N}"

12,345.68

123456789

"{0:N4}"

123,456,789.0000

12345.6789

"Total : {0:C}"

Total : 12 345,68 $

Pour plus d'informations sur les chaînes de mise en forme, consultez Vue d'ensemble des formats.

La valeur de cette propriété est stockée dans l'état d'affichage.

Cette propriété ne peut pas être définie par thèmes ou thèmes de feuille de style. Pour plus d'informations, consultez ThemeableAttribute et Vue d'ensemble des thèmes et des apparences ASP.NET.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0
Afficher: