ListControl.DataTextFormatString Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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, setPublic Overridable Property DataTextFormatString As StringNilai Properti
String pemformatan untuk data yang terikat ke kontrol. Nilai defaultnya adalah Empty.
- Atribut
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.
