BoundField.DataFormatString 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 yang menentukan format tampilan untuk nilai bidang.
public:
virtual property System::String ^ DataFormatString { System::String ^ get(); void set(System::String ^ value); };public virtual string DataFormatString { get; set; }member this.DataFormatString : string with get, setPublic Overridable Property DataFormatString As StringNilai Properti
String pemformatan yang menentukan format tampilan untuk nilai bidang. Defaultnya adalah string kosong (""), yang menunjukkan bahwa tidak ada pemformatan khusus yang diterapkan ke nilai bidang.
Keterangan
DataFormatString Gunakan properti untuk menentukan format tampilan kustom untuk nilai yang ditampilkan dalam BoundField objek. DataFormatString Jika properti tidak diatur, nilai bidang ditampilkan tanpa pemformatan khusus.
Nota
Dalam versi ASP.NET yang lebih lama dari 3.5, Anda harus mengatur HtmlEncode properti ke false untuk memformat bidang yang bukan tipe data string. Jika tidak, nilai bidang dikonversi ke string dengan metode konversi default sebelum string format yang disimpan dalam DataFormatString properti diterapkan.
Secara default, string pemformatan diterapkan ke nilai bidang hanya ketika kontrol terikat data yang berisi BoundField objek berada dalam mode baca-saja. Untuk menerapkan string pemformatan ke nilai bidang saat 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 Item Value: {0}pemformatan , nilai bidang diganti untuk {0} tempat penampung saat string ditampilkan dalam BoundField objek. String pemformatan lainnya ditampilkan sebagai teks harfiah.
Jika string pemformatan tidak menyertakan tempat penampung, hanya string pemformatan itu sendiri yang disertakan dalam teks tampilan akhir (nilai bidang dari sumber data tidak disertakan). Jika tempat penampung adalah 0 (nol) yang diapit kurung kurawal seperti yang ditunjukkan dalam contoh sebelumnya, nilai bidang dikonversi menjadi string dengan metode default. Anda dapat menambahkan ke nol string yang menentukan bagaimana nilai bidang harus diformat. Misalnya, tempat penampung {0:C} untuk bidang numerik menentukan bahwa nilai bidang harus dikonversi ke format mata uang.
Pemformatan diterapkan dengan menggunakan Format metode . Angka yang mengikuti kurung kurawal kiri adalah bagian dari sintaks yang digunakan oleh metode tersebut dan menunjukkan serangkaian nilai mana yang harus digunakan tempat penampung. Karena hanya ada satu nilai bidang di setiap sel, angka yang mengikuti kurung kurawal kiri hanya dapat diatur ke 0.
Tabel berikut mencantumkan karakter format standar untuk bidang numerik. Karakter format ini tidak peka huruf besar/kecil, kecuali untuk X, yang menampilkan karakter heksadesimal dalam kasus yang ditentukan. Anda dapat menambahkan angka ke sebagian besar karakter format untuk menentukan berapa banyak digit signifikan atau tempat desimal yang ingin Anda tampilkan.
Nota
Dalam kebanyakan kasus, pemformatan tergantung pada pengaturan budaya server. Contohnya adalah untuk pengaturan en-USbudaya .
| Format karakter | Deskripsi | Example |
|---|---|---|
C atau c |
Menampilkan nilai numerik dalam format mata uang. Anda dapat menentukan jumlah tempat desimal. | Format: {0:C}123.456 -> \$123,46 Format: {0:C3}123.456 -> \$123,456 |
D atau d |
Menampilkan nilai bilangan bulat dalam format desimal. Anda dapat menentukan jumlah digit. (Meskipun jenis disebut sebagai "desimal", angka diformat sebagai bilangan bulat.) | Format: {0:D}1234 -> 1234 Format: {0:D6}1234 -> 001234 |
E atau e |
Menampilkan nilai numerik dalam format ilmiah (eksponensial). Anda dapat menentukan jumlah tempat desimal. | Format: {0:E}1052.0329112756 -> 1.052033E+003 Format: {0:E2}-1052.0329112756 -> -1.05e+003 |
F atau f |
Menampilkan nilai numerik dalam format tetap. Anda dapat menentukan jumlah tempat desimal. | Format: {0:F}1234.567 -> 1234.57 Format: {0:F3}1234.567 -> 1234.567 |
G atau g |
Menampilkan nilai numerik dalam format umum (yang paling ringkas dari notasi titik tetap atau ilmiah). Anda dapat menentukan jumlah digit signifikan. | Format: {0:G}-123.456 -> -123.456 Format: {0:G2}-123.456 -> -120 |
N atau n |
Menampilkan nilai numerik dalam format angka (termasuk pemisah grup dan tanda negatif opsional). Anda dapat menentukan jumlah tempat desimal. | Format: {0:N}1234.567 -> 1.234,57 Format: {0:N4}1234.567 -> 1.234,5670 |
P atau p |
Menampilkan nilai numerik dalam format persen. Anda dapat menentukan jumlah tempat desimal. | Format: {0:P}1 -> 100.00% Format: {0:P1}.5 -> 50.0% |
R atau r |
SingleMenampilkan nilai , Double, atau BigInteger dalam format pulang-pergi. |
Format: {0:R}123456789.12345678 -> 123456789.12345678 |
X atau x |
Menampilkan nilai bilangan bulat dalam format heksadesimal. Anda dapat menentukan jumlah digit. | Format: {0:X}255 -> FF Format: {0:x4}255 -> 00ff |
Untuk informasi selengkapnya dan untuk contoh yang memperlihatkan pemformatan untuk nilai budaya lainnya, lihat String Format Numerik Standar. Anda juga dapat membuat string format numerik kustom. Untuk informasi selengkapnya, lihat String Format Numerik Kustom.
Tabel berikut ini mencantumkan karakter format untuk DateTime bidang. Sebagian besar spesifikasi pemformatan ini menghasilkan output yang berbeda tergantung pada pengaturan budaya. Contohnya adalah untuk DateTime nilai 15/6/2009 13:45:30 DENGAN pengaturan en-USbudaya .
| Format karakter | Deskripsi | Example |
|---|---|---|
d |
Pola tanggal pendek. | Format: {0:d}15/6/2009 13:45:30 -> 15/6/2009 |
D |
Pola tanggal panjang. | Format: {0:D}15/6/2009 13:45:30 ->Senin, 15 Juni 2009 |
f |
Pola tanggal/waktu lengkap (waktu pendek). | Format: {0:f}15/6/2009 13:45:30 -> Senin, 15 Juni 2009 13:45 |
F |
Pola tanggal/waktu lengkap (waktu yang panjang). | Format: {0:F}15/6/2009 13:45:30 -> Senin, 15 Juni 2009 13:45:30 WIB |
g |
Pola tanggal/waktu umum (waktu pendek). | Format: {0:g}15/6/2009 13:45:30 -> 15/6/2009 13:45 |
G |
Pola tanggal/waktu umum (waktu panjang). | Format: {0:G}15/6/2009 13:45:30 -> 15/6/2009 13:45:30 |
M atau m |
Pola bulan/hari. | Format: {0:M}15/6/2009 13:45:30 -> 15 Juni |
O atau o |
Pola tanggal/waktu pulang pergi. | Format: {0:o}15/6/2009 1:45:30 PM -> 2009-06-15T13:45:30.0900000 |
R atau r |
pola RFC1123 (untuk informasi, lihat DateTimeFormatInfo.RFC1123Pattern). | Format: {0:R}15/6/2009 13:45:30 -> Senin, 15 Jun 2009 20:45:30 GMT |
s |
Pola tanggal/waktu yang dapat diurutkan. | Format: {0:s}15/6/2009 1:45:30 PM -> 2009-06-15T13:45:30 |
t |
Pola waktu pendek. | Format: {0:t}15/6/2009 13:45:30 -> 13:45 |
T |
Pola waktu panjang. | Format: {0:T}15/6/2009 13:45:30 -> 13:45:30 |
u |
Pola tanggal/waktu universal yang dapat diurutkan. | Format: {0:u}15/6/2009 1:45:30 PM -> 2009-06-15 20:45:30Z |
U |
Pola tanggal/waktu lengkap universal. | Format: {0:U}15/6/2009 13:45:30 -> Senin, 15 Juni 2009 20:45:30 WIB |
Y atau y |
Pola bulan tahun. | Format: {0:Y}15/6/2009 13:45:30 -> Juni 2009 |
Untuk informasi selengkapnya dan untuk contoh yang memperlihatkan pemformatan untuk nilai budaya lainnya, lihat String Format Tanggal dan Waktu Standar. Anda juga dapat membuat string format tanggal dan waktu kustom. Untuk informasi selengkapnya, lihat String Format Tanggal dan Waktu Kustom.
