Partager via

BoundField.DataFormatString Propriété

Définition

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

Obtient ou définit la chaîne qui spécifie le format d’affichage de la valeur du champ.

public:
 virtual property System::String ^ DataFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataFormatString { get; set; }
member this.DataFormatString : string with get, set
Public Overridable Property DataFormatString As String

Valeur de propriété

String

Chaîne de mise en forme qui spécifie le format d’affichage de la valeur du champ. La valeur par défaut est une chaîne vide («  »), qui indique qu’aucune mise en forme spéciale n’est appliquée à la valeur du champ.

Remarques

Utilisez la DataFormatString propriété pour spécifier un format d’affichage personnalisé pour les valeurs affichées dans l’objet BoundField . Si la DataFormatString propriété n’est pas définie, la valeur du champ est affichée sans mise en forme spéciale.

Note

Dans les versions de ASP.NET antérieures à la version 3.5, vous devez définir la HtmlEncode propriété false pour mettre en forme les champs qui ne sont pas des types de données de chaîne. Sinon, la valeur du champ est convertie en chaîne par la méthode de conversion par défaut avant l’application de la chaîne de format stockée dans la DataFormatString propriété.

Par défaut, la chaîne de mise en forme est appliquée à la valeur de champ uniquement lorsque le contrôle lié aux données qui contient l’objet BoundField est en mode lecture seule. Pour appliquer la chaîne de mise en forme aux valeurs de champ en mode édition, définissez la ApplyFormatInEditMode propriété truesur .

La chaîne de mise en forme peut être n’importe quelle chaîne littérale et inclut généralement un espace réservé pour la valeur du champ. Par exemple, dans la chaîne Item Value: {0}de mise en forme, la valeur du champ est remplacée par l’espace {0} réservé lorsque la chaîne est affichée dans l’objet BoundField . Le reste de la chaîne de mise en forme s’affiche sous forme de texte littéral.

Si la chaîne de mise en forme n’inclut pas d’espace réservé, seule la chaîne de mise en forme elle-même est incluse dans le texte d’affichage final (la valeur du champ de la source de données n’est pas incluse). Si l’espace réservé est un 0 (zéro) placé entre accolades, comme indiqué dans l’exemple précédent, la valeur du champ est convertie en chaîne par la méthode par défaut. Vous pouvez ajouter à zéro une chaîne qui spécifie la façon dont la valeur de champ doit être mise en forme. Par exemple, l’espace réservé {0:C} d’un champ numérique spécifie que la valeur du champ doit être convertie en format monétaire.

La mise en forme est appliquée à l’aide de la Format méthode. Le nombre qui suit l’accolade gauche fait partie de la syntaxe utilisée par cette méthode et indique l’une des valeurs que l’espace réservé doit utiliser. Étant donné qu’il n’existe qu’une seule valeur de champ dans chaque cellule, le nombre qui suit l’accolade gauche ne peut être défini que sur 0.

Le tableau suivant répertorie les caractères de format standard pour les champs numériques. Ces caractères de format ne respectent pas la casse, sauf pour X, qui affiche des caractères hexadécimaux dans le cas spécifié. Vous pouvez ajouter un nombre à la plupart des caractères de format pour spécifier le nombre de chiffres significatifs ou de décimales à afficher.

Note

Dans la plupart des cas, la mise en forme dépend du paramètre de culture du serveur. Les exemples concernent un paramètre de culture de en-US.

Caractère de mise en forme Description Exemple
C ou c Affiche les valeurs numériques au format monétaire. Vous pouvez spécifier le nombre de décimales. Format : {0:C}

123.456 -> \$123.46

Format : {0:C3}

123.456 -> \$123.456
D ou d Affiche les valeurs entières au format décimal. Vous pouvez spécifier le nombre de chiffres. (Bien que le type soit appelé « décimal », les nombres sont mis en forme en tant qu’entiers.) Format : {0:D}

1234 -> 1234

Format : {0:D6}

1234 -> 001234
E ou e Affiche les valeurs numériques au format scientifique (exponentiel). Vous pouvez spécifier le nombre de décimales. Format : {0:E}

1052.0329112756 -> 1.052033E+003

Format : {0:E2}

-1052.0329112756 -> -1.05e+003
F ou f Affiche des valeurs numériques au format fixe. Vous pouvez spécifier le nombre de décimales. Format : {0:F}

1234.567 -> 1234.57

Format : {0:F3}

1234.567 -> 1234.567
G ou g Affiche les valeurs numériques au format général (le plus compact de la notation à virgule fixe ou scientifique). Vous pouvez spécifier le nombre de chiffres significatifs. Format : {0:G}

-123.456 -> -123.456

Format : {0:G2}

-123.456 -> -120
N ou n Affiche les valeurs numériques au format numérique (y compris les séparateurs de groupe et le signe négatif facultatif). Vous pouvez spécifier le nombre de décimales. Format : {0:N}

1234.567 -> 1 234.57

Format : {0:N4}

1234.567 -> 1 234.5670
P ou p Affiche les valeurs numériques au format pourcentage. Vous pouvez spécifier le nombre de décimales. Format : {0:P}

1 -> 100.00%

Format : {0:P1}

.5 -> 50.0%
R ou r Affiche Single, Doubleou BigInteger les valeurs au format aller-retour. Format : {0:R}

123456789.12345678 -> 123456789.12345678
X ou x Affiche les valeurs entières au format hexadécimal. Vous pouvez spécifier le nombre de chiffres. Format : {0:X}

255 -> FF

Format : {0:x4}

255 -> 00ff

Pour plus d’informations et pour obtenir des exemples qui montrent la mise en forme pour d’autres valeurs de culture, consultez Chaînes de format numérique standard. Vous pouvez également créer des chaînes de format numérique personnalisées. Pour plus d’informations, consultez Chaînes de format numérique personnalisées.

Le tableau suivant répertorie les caractères de format des DateTime champs. La plupart de ces spécifications de mise en forme entraînent une sortie différente en fonction des paramètres de culture. Les exemples concernent une DateTime valeur de 6/15/2009 1:45:30 avec un paramètre de culture de en-US.

Caractère de mise en forme Description Exemple
d Modèle de date courte. Format : {0:d}

15/06/2009 1:45:30 -> 15/15/2009
D Modèle de date longue. Format : {0:D}

15/06/2009 1:45:30 ->lundi 15 juin 2009
f Modèle de date/heure complet (heure courte). Format : {0:f}

15/06/2009 1:45:30 -> lundi 15 juin 2009 1:45 PM
F Modèle de date/heure complet (heure longue). Format : {0:F}

15/06/2009 1:45:30 -> lundi 15 juin 2009 1:45:30
g Modèle de date/heure général (heure courte). Format : {0:g}

15/06/2009 1:45:30 PM -> 15/15/2009 1:45 PM
G Modèle de date/heure général (heure longue). Format : {0:G}

15/06/2009 1:45:30 -> 15/15/2009 1:45:30
M ou m Modèle de mois/jour. Format : {0:M}

15/06/2009 1:45:30 -> 15 juin
O ou o Modèle date/heure aller-retour. Format : {0:o}

15/06/2009 1:45:30 -> 2009-06-15T13:45:30.0900000
R ou r modèle RFC1123 (pour plus d’informations, voir DateTimeFormatInfo.RFC1123Pattern). Format : {0:R}

15/6/2009 1:45:30 -> Mon, 15 juin 2009 2009 20:45:30 GMT
s Modèle de date/heure pouvant être trié. Format : {0:s}

15/06/2009 1:45:30 -> 2009-06-15T13:45:30
t Modèle d’heure courte. Format : {0:t}

15/06/2009 1:45:30 -> 13:45 PM
T Modèle d’heure longue. Format : {0:T}

15/06/2009 1:45:30 -> 1:45:30
u Modèle de date/heure universel pouvant être trié. Format : {0:u}

15/06/2009 1:45:30 -> 2009-06-15 20:45:30Z
U Modèle de date/heure complète universelle. Format : {0:U}

15/06/2009 1:45:30 -> lundi 15 juin 2009 8:45:30
Y ou y Modèle d’année/mois. Format : {0:Y}

15/06/2009 1:45:30 -> Juin 2009

Pour plus d’informations et pour obtenir des exemples qui montrent la mise en forme pour d’autres valeurs de culture, consultez Chaînes de format de date et d’heure standard. Vous pouvez également créer des chaînes de format de date et d’heure personnalisées. Pour plus d’informations, consultez Chaînes de format de date et d’heure personnalisées.

S’applique à

Voir aussi