DisplayFormatAttribute.DataFormatString Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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; }public string? DataFormatString { get; set; }member this.DataFormatString : string with get, setPublic Property DataFormatString As StringValeur de propriété
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.
