DisplayFormatAttribute.DataFormatString Vlastnost

Definice

Obor názvů:

System.ComponentModel.DataAnnotations

Sestavení:

System.ComponentModel.Annotations.dll

Zdroj:

DisplayFormatAttribute.cs

Získá nebo nastaví formát zobrazení pro hodnotu pole.

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

Hodnota vlastnosti

String

Formátovací řetězec, který určuje formát zobrazení pro hodnotu datového pole. Výchozí hodnota je prázdný řetězec (""), který označuje, že pro hodnotu pole není použito žádné zvláštní formátování.

Příklady

Následující příklady ukazují, jak pomocí DataFormatString vlastnosti nastavit formát zobrazení datových polí. První příklad nastaví formát zobrazení pro datové pole typu měny. Druhý příklad nastaví formát zobrazení pro datové pole typu data.

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

Poznámky

DataFormatString Vlastnost slouží k určení vlastního formátu zobrazení pro hodnoty, které jsou zobrazeny v objektuDynamicField. DataFormatString Pokud vlastnost není nastavená, zobrazí se hodnota pole bez speciálního formátování. Další informace najdete v článku o typech formátování.

Poznámka

DynamicField.HtmlEncode Pokud je truevlastnost , hodnota pole je kódována ve formátu HTML do jeho řetězcové reprezentace před použití formátovací řetězec. U některých objektů, například kalendářních dat, můžete chtít určit, jak se objekt zobrazí pomocí formátovacího řetězce. V takových případech musíte vlastnost nastavit DynamicField.HtmlEncode na false.

Ve výchozím nastavení se formátovací řetězec použije na hodnotu pole pouze v případě, že je ovládací prvek vázaný na data, který obsahuje DynamicField objekt, v režimu jen pro čtení. Pokud chcete formátovací řetězec použít na hodnoty polí v režimu úprav, nastavte ApplyFormatInEditMode vlastnost na true.

Formátovací řetězec může být libovolný řetězec literálu a obvykle obsahuje zástupný symbol pro hodnotu pole. Například ve formátovacím řetězci "Item Value: {0}" je hodnota pole nahrazena {0} zástupným symbolem, když je řetězec zobrazen v objektu DynamicField . Zbývající formátovací řetězec se zobrazí jako text literálu.

Poznámka

Pokud formátovací řetězec neobsahuje zástupný symbol, hodnota pole ze zdroje dat není zahrnuta do konečného zobrazovaného textu.

Viz také

• Typy formátování v .NET