DisplayFormatAttribute.DataFormatString Özellik

Tanım

Ad Alanı:

System.ComponentModel.DataAnnotations

Bütünleştirilmiş Kod:

System.ComponentModel.Annotations.dll

Kaynak:

DisplayFormatAttribute.cs

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

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

Özellik Değeri

String

Veri alanını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

Aşağıdaki örneklerde, veri alanlarının DataFormatString görüntü biçimini ayarlamak için özelliğinin nasıl kullanılacağı gösterilmektedir. İlk örnek, para birimi türü veri alanı için görüntüleme biçimini ayarlar. İkinci örnek, tarih türü veri alanı için görüntüleme biçimini ayarlar.

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

Açıklamalar

nesnesinde DataFormatStringDynamicField 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. Daha fazla bilgi için bkz. Biçimlendirme Türleri.

Not

DynamicField.HtmlEncode özelliği olduğundatrue, biçimlendirme dizesi uygulanmadan önce alanın değeri, dize gösterimiyle kodlanmış HTML'dir. Tarihler gibi bazı nesneler için, nesnenin biçimlendirme dizesiyle nasıl görüntüleneceğini denetlemek isteyebilirsiniz. Böyle durumlarda özelliğini olarak falseayarlamanız DynamicField.HtmlEncode gerekir.

Varsayılan olarak, biçimlendirme dizesi alan değerine yalnızca nesneyi içeren DynamicField veriye bağlı denetim salt okunur modda olduğunda uygulanır. Biçimlendirme dizesini düzenleme modundayken 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, "Öğe Değeri: {0}" biçimlendirme dizesinde, dize nesnede DynamicField görüntülendiğinde alanın değeri yer tutucuyla değiştirilir{0}. Biçimlendirme dizesinin geri kalanı değişmez metin olarak görüntülenir.

Not

Biçimlendirme dizesi yer tutucu içermiyorsa, alanın veri kaynağındaki değeri son görüntüleme metnine dahil değildir.

Ayrıca bkz.

• .NET'te Biçimlendirme Türleri