BoundField.DataFormatString Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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é zvláštní formátování.

Příklady

K dispozici je projekt webu sady Visual Studio se zdrojovým kódem, který doprovází toto téma: Stáhnout.

Následující příklad ukazuje, jak použít DataFormatString vlastnost k určení vlastního formátu zobrazení pro hodnoty pole.

Následující příklad ukazuje jeden řádek výstupu, který je vytvořen v tomto příkladu.

ProductID	Name	ProductNumber	Listprice	Hmotnost	Modifieddate
`000680`	`HL Road Frame - Black, 58`	`#FR-R92B-58`	`$1,431.50`	`1016.040`	`3/11/2004`

Poznámky

DataFormatString Pomocí vlastnosti určete vlastní formát zobrazení pro hodnoty, které jsou zobrazeny v objektuBoundField. DataFormatString Pokud vlastnost není nastavená, 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 na hodnotu , false aby bylo možné formátovat pole, která nejsou datovými typy řetězců. Jinak je hodnota pole převedena na řetězec výchozí metodou převodu před použitím 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 je ovládací prvek vázaný na data, který obsahuje BoundField 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ý symbol, když je řetězec zobrazen v objektu BoundField . Zbývající formátovací řetězec se zobrazí jako literálový text.

Pokud formátovací řetězec neobsahuje zástupný symbol, je do konečného zobrazovaného textu zahrnut pouze samotný formátovací řetězec (hodnota pole ze zdroje dat není zahrnuta). Pokud je zástupný symbol 0 (nula) uzavřený do složených závorek, jak je znázorněno v předchozím příkladu, hodnota pole je převedena na řetězec výchozí metodou. K nule můžete připojit řetězec, který určuje, jak má být hodnota pole formátována. Zástupný symbol {0:C} číselného pole například určuje, že hodnota pole se má 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 složenou závorkou, je součástí syntaxe používané danou metodou a označuje, kterou z řady hodnot má zástupný symbol použít. Vzhledem k tomu, že v každé buňce je pouze jedna hodnota pole, může být číslo, které následuje za levou složenou závorkou, nastaveno pouze na hodnotu 0.

Následující tabulka uvádí znaky standardního formátu číselných polí. U těchto znaků formátu se nerozlišují velká a malá písmena, s výjimkou X, který v zadaném případě zobrazuje šestnáctkové znaky. K většině formátovacích znaků můžete přidat číslo, abyste určili, kolik platných číslic nebo desetinných míst chcete zobrazit.

Poznámka

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

Formát znaku	Popis	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 USD Formát: `{0:C3}` 123,456 –> 123 456 USD
`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 "decimal", čísla jsou naformá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 (nejkompaktnější z notace s pevným bodem nebo vědeckým zápisem). Můžete zadat počet platný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 čísel (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 ve formátu procent. 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í Singlehodnoty , Doublenebo `BigInteger` 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, najdete v tématu Standardní řetězce číselného formátu. Můžete také vytvořit vlastní řetězce číselného formátu. Další informace najdete v tématu Vlastní řetězce číselného formátu.

Následující tabulka uvádí formátovací znaky pro DateTime pole. 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 6/15/2009 13:45:30 PM s jazykovou verzí nastavenou na en-US.

Formát znaku	Popis	Příklad
`d`	Vzor krátkého formátu data.	Formát: `{0:d}` 15. 6. 2009 13:45:30 -> 15. 6. 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. 6. 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. 6. 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
`O` nebo `o`	Vzor formátu data/času zpátečního převodu.	Formát: `{0:o}` 15.6.2009 13:45:30 -> 2009-06-15T13:45:30.0900000
`R` nebo `r`	Vzor RFC1123 (informace najdete v tématu DateTimeFormatInfo.RFC1123Pattern).	Formát: `{0:R}` 15.6.2009 13:45:30 -> Mon, 15 Jun 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 13: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 formátu data/času.	Formát: `{0:U}` 15.6.2009 13:45:30 -> Pondělí 15. června 2009 20: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é znázorňují formátování pro jiné hodnoty jazykové verze, najdete v tématu Řetězce standardního formátu data a času. Můžete také vytvořit vlastní řetězce formátu data a času. Další informace najdete v tématu Vlastní řetězce formátu data a času.

Platí pro

Sdílet prostřednictvím