DisplayFormatAttribute.DataFormatString Proprietà

Definizione

Spazio dei nomi:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Source:

DisplayFormatAttribute.cs

Ottiene o imposta il formato di visualizzazione per il valore del campo.

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

Valore della proprietà

String

Stringa di formattazione che specifica il formato di visualizzazione per il valore del campo dati. Il valore predefinito è una stringa vuota (""), a indicare che al valore di campo non è stata applicata alcuna formattazione speciale.

Esempio

Negli esempi seguenti viene illustrato come utilizzare la DataFormatString proprietà per impostare il formato di visualizzazione dei campi dati. Il primo esempio imposta il formato di visualizzazione per un campo dati di tipo valuta. Nel secondo esempio viene impostato il formato di visualizzazione per un campo dati di tipo data.

// 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

Commenti

Utilizzare la DataFormatString proprietà per specificare un formato di visualizzazione personalizzato per i valori visualizzati nell'oggetto DynamicField . Se la DataFormatString proprietà non è impostata, il valore del campo viene visualizzato senza alcuna formattazione speciale. Per altre informazioni, vedere Formattazione di tipi.

Nota

Quando la DynamicField.HtmlEncode proprietà è true, il valore del campo viene codificato html nella relativa rappresentazione di stringa prima dell'applicazione della stringa di formattazione. Per alcuni oggetti, ad esempio date, è possibile controllare la modalità di visualizzazione dell'oggetto con una stringa di formattazione. In questi casi, è necessario impostare la DynamicField.HtmlEncode proprietà su false.

Per impostazione predefinita, la stringa di formattazione viene applicata al valore del campo solo quando il controllo associato a dati che contiene l'oggetto DynamicField è in modalità di sola lettura. Per applicare la stringa di formattazione ai valori dei campi quando sono in modalità di modifica, impostare la ApplyFormatInEditMode proprietà su true.

La stringa di formattazione può essere qualsiasi stringa letterale e in genere include un segnaposto per il valore del campo. Ad esempio, nella stringa di formattazione "Valore elemento: {0}", il valore del campo viene sostituito dal {0} segnaposto quando la stringa viene visualizzata nell'oggetto DynamicField . Il resto della stringa di formattazione viene visualizzato come testo letterale.

Nota

Se la stringa di formattazione non include un segnaposto, il valore del campo dall'origine dati non è incluso nel testo di visualizzazione finale.

Vedi anche

• Formattazione di tipi in .NET