Sdílet prostřednictvím

BoundField.DataFormatString Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví řetězec, který určuje formát zobrazení pro hodnotu pole.

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

Hodnota vlastnosti

String

Formátovací řetězec, který určuje formát zobrazení pro hodnotu 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í.

Poznámky

DataFormatString Pomocí vlastnosti zadejte vlastní formát zobrazení pro hodnoty, které jsou zobrazeny v objektuBoundField. DataFormatString Pokud vlastnost není nastavena, zobrazí se hodnota pole bez speciálního formátování.

Poznámka:

Ve verzích ASP.NET starších než 3.5 je nutné nastavit HtmlEncode vlastnost tak, aby false formátovat pole, která nejsou řetězcovými datovými typy. Jinak je hodnota pole převedena na řetězec ve výchozím způsobu převodu před formátovací řetězec, který je uložen ve DataFormatString vlastnosti.

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í BoundField objekt je v režimu jen pro čtení. Chcete-li použít formátovací řetězec na hodnoty polí 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 Item Value: {0}se hodnota pole nahradí {0} zástupný symbol, když se řetězec zobrazí v objektu BoundField . Zbývající formátovací řetězec se zobrazí jako literálový text.

Pokud řetězec formátování neobsahuje zástupný symbol, zahrne se do konečného zobrazovaného textu pouze samotný formátovací řetězec (hodnota pole ze zdroje dat není zahrnuta). Pokud je zástupný symbol 0 (nula) uzavřený ve složených závorkách, jak je znázorněno v předchozím příkladu, hodnota pole se ve výchozím nastavení převede na řetězec. K nule můžete připojit řetězec, který určuje, jak má být hodnota pole formátována. Například zástupný symbol {0:C} číselného pole určuje, že hodnota pole by se měla převést na formát měny.

Formátování se použije pomocí Format metody. Číslo, které následuje za levou složenou závorkou, je součástí syntaxe používané danou metodou a označuje, kterou z řad hodnot má zástupný symbol použít. Vzhledem k tomu, že v každé buňce je jenom jedna hodnota pole, může být číslo, které následuje za levou složenou závorkou, nastaveno pouze na 0.

V následující tabulce jsou uvedeny standardní znaky formátu číselných polí. Tyto znaky formátu nerozlišují malá a velká písmena, s výjimkou Xznaků, které zobrazují šestnáctkové znaky v zadaném případě. K většině znaků formátu můžete připojit číslo, abyste určili, kolik platných číslic nebo desetinných míst chcete zobrazit.

Poznámka:

Ve většině případů formátování závisí na nastavení jazykové verze serveru. Příklady jsou pro nastavení jazykové verze en-US.

Formát znaku Description Příklad
C nebo c Zobrazí číselné hodnoty ve formátu měny. Můžete zadat počet desetinných míst. Formát: {0:C}

123,456 -> \$123,46

Formát: {0:C3}

123,456 -> \$123,456
D nebo d Zobrazí celočíselné hodnoty v desítkovém formátu. Můžete zadat počet číslic. (I když se typ označuje jako desetinné číslo, čísla jsou formátovaná jako celá čísla.) Formát: {0:D}

1234 -> 1234

Formát: {0:D6}

1234 -> 001234
E nebo e Zobrazí číselné hodnoty ve vědeckém (exponenciálním) formátu. Můžete zadat počet desetinných míst. Formát: {0:E}

1052.0329112756 -> 1.052033E+003

Formát: {0:E2}

-1052.0329112756 -> -1.05e+003
F nebo f Zobrazí číselné hodnoty v pevném formátu. Můžete zadat počet desetinných míst. Formát: {0:F}

1234.567 -> 1234.57

Formát: {0:F3}

1234.567 -> 1234.567
G nebo g Zobrazí číselné hodnoty v obecném formátu (nejkomprimovanější z pevné nebo vědecké notace). Můžete zadat počet významných číslic. Formát: {0:G}

-123.456 -> -123.456

Formát: {0:G2}

-123,456 -> -120
N nebo n Zobrazí číselné hodnoty ve formátu čísla (včetně oddělovačů skupin a volitelného záporného znaménka). Můžete zadat počet desetinných míst. Formát: {0:N}

1234,567 -> 1 234,57

Formát: {0:N4}

1234,567 -> 1 234,5670
P nebo p Zobrazí číselné hodnoty v procentech formátu. Můžete zadat počet desetinných míst. Formát: {0:P}

1 –> 100,00%

Formát: {0:P1}

.5 –> 50.0%
R nebo r Zobrazí Singlehodnotu , Doublenebo BigInteger hodnoty ve formátu odezvy. Formát: {0:R}

123456789.12345678 -> 123456789.12345678
X nebo x Zobrazí celočíselné hodnoty v šestnáctkovém formátu. Můžete zadat počet číslic. Formát: {0:X}

255 -> FF

Formát: {0:x4}

255 -> 00ff

Další informace a příklady, které zobrazují formátování pro jiné hodnoty jazykové verze, naleznete v tématu Standardní řetězce číselného formátu. Můžete také vytvořit vlastní řetězce číselného formátu. Další informace naleznete v tématu Vlastní řetězce číselného formátu.

V následující tabulce jsou uvedeny znaky formátu polí DateTime . Většina těchto specifikací formátování vede k jinému výstupu v závislosti na nastavení jazykové verze. Příklady jsou pro DateTime hodnotu 15.6.2009 13:45:30 s nastavením jazykové verze en-US.

Formát znaku Description Příklad
d Vzor krátkého formátu data. Formát: {0:d}

15.6.2009 13:45:30 -> 15.15.2009
D Vzor dlouhého formátu data. Formát: {0:D}

15.6.2009 13:45:30 –>pondělí, 15. června 2009
f Vzor úplného formátu data/času (krátkého formátu času). Formát: {0:f}

15.6.2009 13:45:30 –> pondělí, 15. června 2009 13:45
F Vzor úplného formátu data/času (dlouhého formátu času). Formát: {0:F}

15.6.2009 13:45:30 –> pondělí, 15. června 2009 13:45:30
g Vzor obecného formátu data/času (krátkého formátu času). Formát: {0:g}

15.6.2009 13:45:30 -> 15.15.2009 13:45
G Vzor obecného formátu data a času (dlouhého formátu času). Formát: {0:G}

15.6.2009 13:45:30-15.15.2009> 13:45:30
M nebo m Vzor formátu měsíce/dne. Formát: {0:M}

15.6.2009 13:45:30 –> 15. června 15
O nebo o Vzor data a času odezvy. Formát: {0:o}

15.6.2009 13:45:30 -> 2009-06-15T13:45:30.09000000
R nebo r RFC1123 vzor (informace naleznete v tématu DateTimeFormatInfo.RFC1123Pattern). Formát: {0:R}

15.6.2009 13:45:30 –> Po, 15. června 2009 20:45:30 GMT
s Vzor seřaditelného formátu data/času. Formát: {0:s}

15.6.2009 13:45:30 -> 2009-06-15T13:45:30
t Vzor krátkého formátu času. Formát: {0:t}

15.6.2009 13:45:30 –> 13:45
T Vzor dlouhého formátu času. Formát: {0:T}

15.6.2009 1:45:30–> 13:45:30
u Vzor univerzálního seřaditelného formátu data/času. Formát: {0:u}

15.6.2009 13:45:30 -> 2009-06-15 20:45:30Z
U Vzor univerzálního úplného data a času Formát: {0:U}

15.6.2009 13:45:30 –> pondělí, 15. června 2009 8:45:30
Y nebo y Vzor formátu roku a měsíce. Formát: {0:Y}

15.6.2009 13:45:30 –> červen 2009

Další informace a příklady, které zobrazují formátování pro jiné hodnoty jazykové verze, naleznete v tématu Standardní řetězce formátu data a času. Můžete také vytvořit vlastní řetězce formátu data a času. Další informace naleznete v tématu Vlastní řetězce formátu data a času.

Platí pro

Viz také