ListControl.DataTextFormatString Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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.

public:
 virtual property System::String ^ DataTextFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataTextFormatString { get; set; }
[System.Web.UI.Themeable(false)]
public virtual string DataTextFormatString { get; set; }
member this.DataTextFormatString : string with get, set
[<System.Web.UI.Themeable(false)>]
member this.DataTextFormatString : string with get, set
Public Overridable Property DataTextFormatString As String

Valeur de propriété

String

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

Attributs
ThemeableAttribute

Remarques

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

La chaîne de format de données se compose de deux parties, séparées par un signe deux-points, au format { A : Bxx }. Par exemple, la chaîne {0:F2} de mise en forme met en forme la cellule pour afficher un nombre à points fixes avec deux décimales.

Notes

La chaîne entière doit être placée dans des accolades pour indiquer qu’il s’agit d’une chaîne de format et non d’une chaîne littérale. Tout texte en dehors des accolades s’affiche sous forme de texte littéral.

La valeur avant les deux-points (A dans l’exemple général) spécifie l’index de paramètre dans une liste de paramètres de base zéro.

Notes

Cette valeur ne peut être définie que sur 0, car il n’y a qu’une seule valeur dans chaque cellule.

Le caractère après les deux-points (B dans l’exemple général) spécifie le format dans lequel afficher la valeur. Le tableau suivant répertorie les formats courants.

Caractère de mise en forme 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.

Notes

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

La valeur 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 contient des exemples de chaînes de mise en forme et des résultats. Il suppose des paramètres d’anglais standard.

Valeur numérique Chaîne de format Résultats
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 : 12345,68 $

Pour plus d’informations sur la mise en forme des chaînes, consultez Mise en forme des types.

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

Cette propriété ne peut pas être définie par les thèmes ou les thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET thèmes et skins.

S’applique à

Voir aussi