DisplayFormatAttribute.DataFormatString Właściwość

Definicja

Przestrzeń nazw:

System.ComponentModel.DataAnnotations

Zestaw:

System.ComponentModel.Annotations.dll

Źródło:

DisplayFormatAttribute.cs

Pobiera lub ustawia format wyświetlania wartości pola.

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

Wartość właściwości

String

Ciąg formatowania określający format wyświetlania dla wartości pola danych. Wartość domyślna to pusty ciąg (""), który wskazuje, że żadne specjalne formatowanie nie jest stosowane do wartości pola.

Przykłady

W poniższych przykładach pokazano, jak za pomocą DataFormatString właściwości ustawić format wyświetlania pól danych. Pierwszy przykład ustawia format wyświetlania dla pola danych typu waluty. Drugi przykład ustawia format wyświetlania dla pola danych typu daty.

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

Uwagi

DataFormatString Użyj właściwości , aby określić niestandardowy format wyświetlania dla wartości wyświetlanych w DynamicField obiekcie. DataFormatString Jeśli właściwość nie jest ustawiona, wartość pola jest wyświetlana bez specjalnego formatowania. Aby uzyskać więcej informacji, zobacz Typy formatowania.

Uwaga

DynamicField.HtmlEncode Gdy właściwość ma truewartość , wartość pola jest zakodowana w formacie HTML do jego reprezentacji ciągu przed zastosowaniem ciągu formatowania. W przypadku niektórych obiektów, takich jak daty, warto kontrolować sposób wyświetlania obiektu za pomocą ciągu formatowania. W takich przypadkach należy ustawić DynamicField.HtmlEncode właściwość na false.

Domyślnie ciąg formatowania jest stosowany do wartości pola tylko wtedy, gdy kontrolka powiązana z danymi zawierająca DynamicField obiekt jest w trybie tylko do odczytu. Aby zastosować ciąg formatowania do wartości pól w trybie edycji, ustaw ApplyFormatInEditMode właściwość na truewartość .

Ciąg formatowania może być dowolnym ciągiem literału i zwykle zawiera symbol zastępczy wartości pola. Na przykład w ciągu formatowania "Wartość elementu: {0}"wartość pola jest zastępowana symbolem zastępczym {0} , gdy ciąg jest wyświetlany w DynamicField obiekcie. Pozostała część ciągu formatowania jest wyświetlana jako tekst literału.

Uwaga

Jeśli ciąg formatowania nie zawiera symbolu zastępczego, wartość pola ze źródła danych nie jest uwzględniona w końcowym tekście wyświetlanym.

Zobacz też

• Typy formatowania na platformie .NET