DisplayFormatAttribute.DataFormatString Properti

Definisi

Ruang nama:

System.ComponentModel.DataAnnotations

Rakitan:

System.ComponentModel.Annotations.dll

Sumber:

DisplayFormatAttribute.cs

Mendapatkan atau mengatur format tampilan untuk nilai bidang.

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

Nilai Properti

String

String pemformatan yang menentukan format tampilan untuk nilai bidang data. Defaultnya adalah string kosong (""), yang menunjukkan bahwa tidak ada pemformatan khusus yang diterapkan ke nilai bidang.

Contoh

Contoh berikut menunjukkan cara menggunakan DataFormatString properti untuk mengatur format tampilan bidang data. Contoh pertama mengatur format tampilan untuk bidang data jenis mata uang. Contoh kedua mengatur format tampilan untuk bidang data jenis tanggal.

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

Keterangan

DataFormatString Gunakan properti untuk menentukan format tampilan kustom untuk nilai yang ditampilkan dalam DynamicField objek. DataFormatString Jika properti tidak diatur, nilai bidang ditampilkan tanpa pemformatan khusus. Untuk informasi selengkapnya, lihat Jenis Pemformatan.

Catatan

DynamicField.HtmlEncode Ketika properti adalah true, nilai bidang dikodekan HTML ke representasi stringnya sebelum string pemformatan diterapkan. Untuk beberapa objek, seperti tanggal, Anda mungkin ingin mengontrol bagaimana objek ditampilkan dengan string pemformatan. Dalam kasus tersebut, Anda harus mengatur properti ke DynamicField.HtmlEncodefalse.

Secara default, string pemformatan diterapkan ke nilai bidang hanya ketika kontrol terikat data yang berisi DynamicField objek berada dalam mode baca-saja. Untuk menerapkan string pemformatan ke nilai bidang saat berada dalam mode edit, atur properti ke ApplyFormatInEditModetrue.

String pemformatan dapat berupa string harfiah apa pun dan biasanya menyertakan tempat penampung untuk nilai bidang. Misalnya, dalam string pemformatan "Nilai Item: {0}", nilai bidang diganti untuk {0} tempat penampung saat string ditampilkan di DynamicField objek . Sisa string pemformatan ditampilkan sebagai teks harfiah.

Catatan

Jika string pemformatan tidak menyertakan tempat penampung, nilai bidang dari sumber data tidak disertakan dalam teks tampilan akhir.

Lihat juga

• Tipe Pemformatan di .NET