Bagikan melalui

ListControl.DataTextFormatString Properti

  • Referensi

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Mendapatkan atau mengatur string pemformatan yang digunakan untuk mengontrol bagaimana data yang terikat ke kontrol daftar ditampilkan.

public:
 virtual property System::String ^ DataTextFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataTextFormatString { get; set; }
[System.Web.UI.Themeable(false)]
public virtual string DataTextFormatString { get; set; }
member this.DataTextFormatString : string with get, set
[<System.Web.UI.Themeable(false)>]
member this.DataTextFormatString : string with get, set
Public Overridable Property DataTextFormatString As String

Nilai Properti

String

String pemformatan untuk data yang terikat ke kontrol. Nilai defaultnya adalah Empty.

Atribut
ThemeableAttribute

Keterangan

DataTextFormatString Gunakan properti untuk menyediakan format tampilan kustom item dalam kontrol daftar.

String format data terdiri dari dua bagian, dipisahkan oleh titik dua, dalam bentuk { A : Bxx }. Misalnya, string {0:F2} pemformatan akan memformat sel untuk menampilkan angka titik tetap dengan dua tempat desimal.

Catatan

Seluruh string harus diapit dalam kurung kurawal untuk menunjukkan bahwa string tersebut adalah string format dan bukan string harfiah. Teks apa pun di luar kurung kurawal ditampilkan sebagai teks harfiah.

Nilai sebelum titik dua (A dalam contoh umum) menentukan indeks parameter dalam daftar parameter berbasis nol.

Catatan

Nilai ini hanya dapat diatur ke 0 karena hanya ada satu nilai di setiap sel.

Karakter setelah titik dua (B dalam contoh umum) menentukan format untuk menampilkan nilai. Tabel berikut mencantumkan format umum.

Format karakter Deskripsi
C Menampilkan nilai numerik dalam format mata uang.
D Menampilkan nilai numerik dalam format desimal.
E Menampilkan nilai numerik dalam format ilmiah (eksponensial).
F Menampilkan nilai numerik dalam format tetap.
G Menampilkan nilai numerik dalam format umum.
N Menampilkan nilai numerik dalam format angka.
X Menampilkan nilai numerik dalam format heksadesimal.

Catatan

Karakter format tidak peka huruf besar/kecil, kecuali untuk X, yang menampilkan karakter heksadesimal dalam kasus yang ditentukan.

Nilai setelah karakter format (xx dalam contoh umum) menentukan jumlah digit signifikan atau tempat desimal untuk ditampilkan.

Tabel berikut berisi contoh string pemformatan dan hasilnya. Ini mengasumsikan pengaturan bahasa Inggris standar.

Nilai Numerik String format Hasil
12345.6789 "{0:C}" $12.345,68
-12345.6789 "{0:C}" ($12.345,68)
12345 "{0:D}" 12345
12345 "{0:D8}" 00012345
12345.6789 "{0:E}" 1234568E+004
12345.6789 "{0:E10}" 1.2345678900E+004
12345.6789 "{0:F}" 12345.68
12345.6789 "{0:F0}" 12346
12345.6789 "{0:G}" 12345.6789
123456789 "{0:G7}" 1.234568E8
12345.6789 "{0:N}" 12,345.68
123456789 "{0:N4}" 123,456,789.0000
12345.6789 "Total: {0:C}" Total: $12345,68

Untuk informasi selengkapnya tentang string pemformatan, lihat Jenis Pemformatan.

Nilai properti ini disimpan dalam status tampilan.

Properti ini tidak dapat diatur oleh tema atau tema lembar gaya. Untuk informasi selengkapnya, lihat ThemeableAttribute dan ASP.NET Tema dan Kulit.

Berlaku untuk

Lihat juga