DisplayFormatAttribute.DataFormatString Propriété

Définition

Espace de noms:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Source:

DisplayFormatAttribute.cs

Obtient ou définit le format d'affichage de la valeur de champ.

public:
 property System::String ^ DataFormatString { System::String ^ get(); void set(System::String ^ value); };

public string? DataFormatString { get; set; }

member this.DataFormatString : string with get, set

Public 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 de données. 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

Les exemples suivants montrent comment utiliser la DataFormatString propriété pour définir le format d’affichage des champs de données. Le premier exemple définit le format d’affichage d’un champ de données de type monétaire. Le deuxième exemple définit le format d’affichage d’un champ de données de type date.

// Display currency data field in the format $1,345.50.
[DisplayFormat(DataFormatString="{0:C}")]
public object StandardCost;

' Display currency data field in the format such as $1,345.50.
<DisplayFormat(DataFormatString:="{0:C}")> _
Public StandardCost As Object

// Display date data field in the short format 11/12/08.
// Also, apply format in edit mode.
[DisplayFormat(ApplyFormatInEditMode=true, DataFormatString = "{0:d}")]
public object SellStartDate;

' Display date data field in the short format such as 11/12/08.
' Also, apply format in edit mode.
<DisplayFormat(ApplyFormatInEditMode:=True, DataFormatString:="{0:d}")> _
Public SellStartDate As Object

Remarques

Utilisez la DataFormatString propriété pour spécifier un format d’affichage personnalisé pour les valeurs affichées dans l’objet DynamicField . Si la DataFormatString propriété n’est pas définie, la valeur du champ s’affiche sans aucune mise en forme spéciale. Pour plus d’informations, consultez Mise en forme des types.

Notes

Lorsque la DynamicField.HtmlEncode propriété est true, la valeur du champ est encodée au format HTML dans sa représentation de chaîne avant l’application de la chaîne de mise en forme. Pour certains objets, tels que des dates, vous pouvez contrôler la façon dont l’objet est affiché avec une chaîne de mise en forme. Dans ce cas, vous devez définir la propriété sur DynamicField.HtmlEncodefalse.

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 DynamicField est en mode lecture seule. Pour appliquer la chaîne de mise en forme aux valeurs de champ lorsqu’elles sont 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 de mise en forme « Valeur de l’élément : {0}», la valeur du champ est remplacée par l’espace {0} réservé lorsque la chaîne est affichée dans l’objet DynamicField . Le reste de la chaîne de mise en forme s’affiche sous forme de texte littéral.

Notes

Si la chaîne de mise en forme n’inclut pas d’espace réservé, la valeur du champ de la source de données n’est pas incluse dans le texte d’affichage final.

Voir aussi

• Mettre en forme des types dans .NET