BoundField.DataFormatString Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Alanın değeri için görüntüleme biçimini belirten dizeyi alır veya ayarlar.

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, set

Public Overridable Property DataFormatString As String

Özellik Değeri

String

Alanın değeri için görüntüleme biçimini belirten bir biçimlendirme dizesi. Varsayılan, alan değerine özel biçimlendirme uygulanmadığını gösteren boş bir dizedir ("").

Örnekler

Kaynak kodu içeren bir Visual Studio Web sitesi projesi şu konuya eşlik edebilir: İndir.

Aşağıdaki örnekte, bir alanın değerleri için özel bir görüntüleme biçimi belirtmek üzere özelliğinin nasıl kullanılacağı DataFormatString gösterilmektedir.

Aşağıdaki örnekte, bu örnek tarafından oluşturulan çıkışın bir satırı gösterilmektedir.

ProductID	Name	Productnumber	Listprice	Ağırlık	Modifieddate
`000680`	`HL Road Frame - Black, 58`	`#FR-R92B-58`	`$1,431.50`	`1016.040`	`3/11/2004`

Açıklamalar

nesnesinde DataFormatString BoundField görüntülenen değerler için özel bir görüntüleme biçimi belirtmek için özelliğini kullanın. DataFormatString Özellik ayarlanmamışsa, alanın değeri herhangi bir özel biçimlendirme olmadan görüntülenir.

Not

3.5'ten önceki ASP.NET sürümlerinde, dize veri türü olmayan alanları biçimlendirmek false için özelliğini olarak ayarlamanız HtmlEncode gerekir. Aksi takdirde, özellikte depolanan biçim dizesi uygulanmadan önce alan değeri varsayılan dönüştürme yöntemiyle bir dizeye DataFormatString dönüştürülür.

Varsayılan olarak, biçimlendirme dizesi alan değerine yalnızca nesneyi içeren BoundField veriye bağlı denetim salt okunur modda olduğunda uygulanır. Düzenleme modundayken biçimlendirme dizesini alan değerlerine uygulamak için özelliğini olarak trueayarlayınApplyFormatInEditMode.

Biçimlendirme dizesi herhangi bir değişmez değer dizesi olabilir ve genellikle alanın değeri için bir yer tutucu içerir. Örneğin, biçimlendirme dizesindeItem Value: {0}, dize nesnesinde görüntülendiğinde BoundField alanın değeri yer tutucuyla değiştirilir{0}. Biçimlendirme dizesinin geri kalanı değişmez metin olarak görüntülenir.

Biçimlendirme dizesi yer tutucu içermiyorsa, son görüntüleme metnine yalnızca biçimlendirme dizesinin kendisi eklenir (alanın veri kaynağındaki değeri dahil değildir). Yer tutucu, önceki örnekte gösterildiği gibi küme ayraçları içine alınmış bir 0 (sıfır) ise, alan değeri varsayılan yöntem tarafından bir dizeye dönüştürülür. Sıfıra, alan değerinin nasıl biçimlendirilmesi gerektiğini belirten bir dize ekleyebilirsiniz. Örneğin, sayısal alanın yer tutucusu {0:C} , alanın değerinin para birimi biçimine dönüştürülmesi gerektiğini belirtir.

Biçimlendirme yöntemi kullanılarak Format uygulanır. Sol küme ayracı izleyen sayı, bu yöntem tarafından kullanılan söz diziminin bir parçasıdır ve yer tutucunun kullanması gereken değer dizilerinden hangisini kullanması gerektiğini belirtir. Her hücrede yalnızca bir alan değeri olduğundan, sol küme ayracı izleyen sayı yalnızca 0 olarak ayarlanabilir.

Aşağıdaki tabloda, sayısal alanlar için standart biçim karakterleri listelenir. Bu biçim karakterleri, belirtilen durumda onaltılık karakterler görüntüleyen dışında Xbüyük/küçük harfe duyarlı değildir. Görüntülemek istediğiniz basamak sayısını veya ondalık basamak sayısını belirtmek için çoğu biçimlendirme karakterine sayı ekleyebilirsiniz.

Not

Çoğu durumda, biçimlendirme sunucunun kültür ayarına bağlıdır. Örnekler, bir kültür ayarına yöneliktir en-US.

Karakter biçimlendirme	Açıklama	Örnek
`C` veya `c`	Sayısal değerleri para birimi biçiminde görüntüler. Ondalık basamak sayısını belirtebilirsiniz.	Biçim: `{0:C}` 123,456 -> $123,46 Biçim: `{0:C3}` 123,456 -> $123,456
`D` veya `d`	Tamsayı değerlerini ondalık biçimde görüntüler. Basamak sayısını belirtebilirsiniz. (Tür "ondalık" olarak ifade edilse de, sayılar tamsayı olarak biçimlendirilir.)	Biçim: `{0:D}` 1234 -> 1234 Biçim: `{0:D6}` 1234 -> 001234
`E` veya `e`	Sayısal değerleri bilimsel (üstel) biçimde görüntüler. Ondalık basamak sayısını belirtebilirsiniz.	Biçim: `{0:E}` 1052.0329112756 -> 1.052033E+003 Biçim: `{0:E2}` -1052.0329112756 -> -1.05e+003
`F` veya `f`	Sayısal değerleri sabit biçimde görüntüler. Ondalık basamak sayısını belirtebilirsiniz.	Biçim: `{0:F}` 1234.567 -> 1234.57 Biçim: `{0:F3}` 1234.567 -> 1234.567
`G` veya `g`	Sayısal değerleri genel biçimde görüntüler (sabit noktalı veya bilimsel gösterimden en küçüktür). Anlamlı basamak sayısını belirtebilirsiniz.	Biçim: `{0:G}` -123.456 -> -123.456 Biçim: `{0:G2}` -123.456 -> -120
`N` veya `n`	Sayısal değerleri sayı biçiminde görüntüler (grup ayırıcıları ve isteğe bağlı negatif işareti dahil). Ondalık basamak sayısını belirtebilirsiniz.	Biçim: `{0:N}` 1234.567 -> 1.234.57 Biçim: `{0:N4}` 1234.567 -> 1.234.5670
`P` veya `p`	Sayısal değerleri yüzde biçiminde görüntüler. Ondalık basamak sayısını belirtebilirsiniz.	Biçim: `{0:P}` 1 -> %100,00 Biçim: `{0:P1}` 0,5 -> %50,0
`R` veya `r`	, Doubleveya `BigInteger` değerlerini gidiş dönüş biçiminde görüntülerSingle.	Biçim: `{0:R}` 123456789.12345678 -> 123456789.12345678
`X` veya `x`	Tamsayı değerlerini onaltılık biçimde görüntüler. Basamak sayısını belirtebilirsiniz.	Biçim: `{0:X}` 255 -> FF Biçim: `{0:x4}` 255 -> 00ff

Daha fazla bilgi ve diğer kültür değerlerinin biçimlendirmesini gösteren örnekler için bkz. Standart Sayısal Biçim Dizeleri. Özel sayısal biçim dizeleri de oluşturabilirsiniz. Daha fazla bilgi için bkz. Özel Sayısal Biçim Dizeleri.

Aşağıdaki tabloda alanlar için DateTime biçim karakterleri listelemektedir. Bu biçimlendirme belirtimlerinin çoğu kültür ayarlarına bağlı olarak farklı bir çıkışla sonuçlanır. Örnekler DateTime , 15.06.2009 13:45:30 değerine ve kültür ayarına yöneliktir en-US.

Biçim karakteri	Açıklama	Örnek
`d`	Kısa Tarih Modeli	Biçim: `{0:d}` 15.06.2009 13:45:30 -> 15.06.2009
`D`	Uzun tarih deseni.	Biçim: `{0:D}` 15.06.2009 13:45:30 ->15 Haziran 2009 Pazartesi
`f`	Tam tarih veya saat deseni (süre).	Biçim: `{0:f}` 15.06.2009 13:45:30 -> 15 Haziran 2009 Pazartesi 13:45
`F`	Tam tarih veya saat deseni (uzun süre).	Biçim: `{0:F}` 15.06.2009 13:45:30 -> 15 Haziran 2009 Pazartesi 13:45:30
`g`	Genel tarih veya saat deseni (süre).	Biçim: `{0:g}` 15.06.2009 13:45:30 -> 15.06.2009 13:45
`G`	Genel tarih veya saat deseni (uzun süre).	Biçim: `{0:G}` 15.06.2009 13:45:30 -> 15.06.2009 13:45:30
`M` veya `m`	Ay/gün deseni.	Biçim: `{0:M}` 15.06.2009 13:45:30 -> 15 Haziran
`O` veya `o`	Gidiş tarihi/saati desen.	Biçim: `{0:o}` 15.06.2009 13:45:30 -> 2009-06-15T13:45:30.0900000
`R` veya `r`	RFC1123 deseni (bilgi için bkz DateTimeFormatInfo.RFC1123Pattern. ).	Biçim: `{0:R}` 15.06.2009 13:45:30 -> Mon, 15 Haziran 2009 20:45:30 GMT
`s`	Sıralanabilir tarih veya saat deseni.	Biçim: `{0:s}` 15.06.2009 13:45:30 -> 2009-06-15T13:45:30
`t`	Kısa bir süre deseni.	Biçim: `{0:t}` 15.06.2009 13:45:30 -> 13:45
`T`	Uzun süre deseni.	Biçim: `{0:T}` 15.06.2009 13:45:30 -> 13:45:30
`u`	Evrensel sıralanabilir tarih/saat deseni.	Biçim: `{0:u}` 15.06.2009 13:45:30 -> 2009-06-15 20:45:30Z
`U`	Evrensel tam tarih/saat deseni.	Biçim: `{0:U}` 15.06.2009 13:45:30 -> 15 Haziran 2009 Pazartesi 20:45:30
`Y` veya `y`	Yıl ay deseni.	Biçim: `{0:Y}` 15.06.2009 13:45:30 -> Haziran 2009

Daha fazla bilgi ve diğer kültür değerleri için biçimlendirmeyi gösteren örnekler için bkz. Standart Tarih ve Saat Biçim Dizeleri. Özel tarih ve saat biçimi dizeleri de oluşturabilirsiniz. Daha fazla bilgi için bkz. Özel Tarih ve Saat Biçim Dizeleri.

Şunlara uygulanır