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 na hodnotu pole není použito žádné speciální 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 datového typu kalendářního typu.

// 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 Pomocí vlastnosti zadejte vlastní formát zobrazení pro hodnoty, které jsou zobrazeny v objektuDynamicField. DataFormatString Pokud vlastnost není nastavena, zobrazí se hodnota pole bez speciálního formátování. Další informace naleznete v tématu Typy formátování.

Poznámka:

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

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

Formátovací řetězec může být libovolný literálový řetězec a obvykle obsahuje zástupný symbol pro hodnotu pole. Například ve formátovacím řetězci "Hodnota položky: {0}"Hodnota položky" se hodnota pole nahradí {0} zástupným symbolem, když se řetězec zobrazí v objektu DynamicField . Zbývající část formátujícího řetězce se zobrazí jako literálový text.

Poznámka:

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

Viz také

• Typy formátování v .NET