DisplayFormatAttribute.DataFormatString Tulajdonság

Definíció

Névtér:

System.ComponentModel.DataAnnotations

Szerelvény:

System.ComponentModel.Annotations.dll

Forrás:

DisplayFormatAttribute.cs

Lekéri vagy beállítja a mezőérték megjelenítési formátumát.

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

Tulajdonság értéke

String

Az adatmező értékének megjelenítési formátumát meghatározó formázási sztring. Az alapértelmezett érték egy üres sztring (""), amely azt jelzi, hogy a mezőértékre nincs speciális formázás alkalmazva.

Példák

Az alábbi példák bemutatják, hogyan használható a tulajdonság az DataFormatString adatmezők megjelenítési formátumának beállítására. Az első példa egy pénznemtípus adatmezőjének megjelenítési formátumát állítja be. A második példa egy dátumtípus adatmező megjelenítési formátumát állítja be.

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

Megjegyzések

DataFormatString A tulajdonság használatával egyéni megjelenítési formátumot adhat meg az objektumban DynamicField megjelenített értékekhez. Ha a DataFormatString tulajdonság nincs beállítva, a mező értéke speciális formázás nélkül jelenik meg. További információ: Formázási típusok.

Note

Ha a DynamicField.HtmlEncode tulajdonság értéke true, a mező értéke a formázási sztring alkalmazása előtt HTML-kóddal van kódolva a sztringre. Egyes objektumok, például dátumok esetében érdemes lehet szabályozni, hogy az objektum hogyan jelenjen meg formázási sztringdel. Ezekben az esetekben a tulajdonságot be kell állítania a DynamicField.HtmlEncode következőre false: .

Alapértelmezés szerint a formázási sztring csak akkor lesz alkalmazva a mezőértékre, ha az DynamicField objektumot tartalmazó adatkötésű vezérlőelem írásvédett módban van. Ha szerkesztési módban szeretné alkalmazni a formázási sztringet a mezőértékekre, állítsa a tulajdonságot a ApplyFormatInEditMode következőre true: .

A formázási sztring bármilyen literális sztring lehet, és általában tartalmaz egy helyőrzőt a mező értékéhez. Az "Elemérték: {0}" formázási sztringben például a mező értéke a helyőrző helyett {0} jelenik meg az DynamicField objektumban. A formázási sztring fennmaradó része literális szövegként jelenik meg.

Note

Ha a formázási sztring nem tartalmaz helyőrzőt, a mező adatforrásból származó értéke nem szerepel a végleges megjelenítési szövegben.

Lásd még

• Formatting Types in .NET