BoundField.DataFormatString 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 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 de champ.

Exemples

Un projet de site Web Visual Studio avec du code source est disponible pour accompagner cette rubrique : Téléchargement.

L’exemple suivant montre comment utiliser la DataFormatString propriété pour spécifier un format d’affichage personnalisé pour les valeurs d’un champ.

L’exemple suivant montre une ligne de la sortie générée par cet exemple.

ProductID Nom RéférenceProduit ListPrice Poids DateModification
000680 HL Road Frame - Black, 58 #FR-R92B-58 $1,431.50 1016.040 3/11/2004

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 s’affiche sans aucune mise en forme spéciale.

Notes

Dans les versions de ASP.NET antérieures à 3.5, vous devez définir la HtmlEncode propriété sur false afin de mettre en forme des 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 que la chaîne de format stockée dans la DataFormatString propriété ne soit appliquée.

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é sur true.

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é dans des 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 au 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} pour 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 celle d’une série de valeurs que l’espace réservé doit utiliser. Étant donné qu’il n’y a 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, à l’exception de 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 afin de spécifier le nombre de chiffres significatifs ou de décimales que vous souhaitez afficher.

Notes

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 sous forme d’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 les 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 (la notation à point fixe ou scientifique la plus compacte). 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 nombre (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 les Singlevaleurs , Doubleou BigInteger 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 de 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ériques 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 aboutissent à une sortie différente en fonction des paramètres de culture. Les exemples concernent une DateTime valeur de 15/06/2009 13: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 13:45:30 -> 15/06/2009
D Modèle de date longue. Format : {0:D}

15/6/2009 13:45:30 -> Lundi, juin 15, 2009
f Modèle de date/heure complet (heure courte). Format : {0:f}

15/6/2009 13:45:30 -> Lundi 15 juin 2009 13:45
F Modèle de date/heure complet (heure longue). Format : {0:F}

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

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

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

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

15/6/2009 13:45:30 -> 2009-06-15T13:45:30.09000000
R ou r Modèle RFC1123 (pour plus d’informations, consultez DateTimeFormatInfo.RFC1123Pattern). Format : {0:R}

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

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

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

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

15/06/2009 13:45:30 -> 2009-06-15 20:45:30Z
U Modèle de date/heure complet universel. Format : {0:U}

15/6/2009 13:45:30 -> Lundi 15 juin 2009 20:45:30
Y ou y Modèle d’année/mois. Format : {0:Y}

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

Pour plus d’informations et pour obtenir des exemples montrant la mise en forme 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