ListControl.DataTextFormatString Vlastnost
Definice
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í formátovací řetězec použitý k řízení způsobu zobrazení dat vázaných na ovládací prvek seznamu.
public:
virtual property System::String ^ DataTextFormatString { System::String ^ get(); void set(System::String ^ value); };public virtual string DataTextFormatString { get; set; }[System.Web.UI.Themeable(false)]
public virtual string DataTextFormatString { get; set; }member this.DataTextFormatString : string with get, set[<System.Web.UI.Themeable(false)>]
member this.DataTextFormatString : string with get, setPublic Overridable Property DataTextFormatString As StringHodnota vlastnosti
Formátovací řetězec pro data vázaná na ovládací prvek. Výchozí hodnota je Empty.
- Atributy
Poznámky
DataTextFormatString Pomocí vlastnosti můžete zadat vlastní formát zobrazení položek v ovládacím prvku seznamu.
Řetězec formátu dat se skládá ze dvou částí oddělených dvojtečkami ve tvaru { A : Bxx }. Například formátovací řetězec {0:F2} by naformátoval buňku tak, aby zobrazovala číslo s pevným bodem se dvěma desetinnými místy.
Poznámka:
Celý řetězec musí být uzavřený ve složených závorkách, aby bylo možné označit, že se jedná o formátovací řetězec, nikoli literálový řetězec. Libovolný text mimo složené závorky se zobrazí jako literálový text.
Hodnota před dvojtečku (A v obecném příkladu) určuje index parametrů v seznamu parametrů založených na nule.
Poznámka:
Tuto hodnotu lze nastavit pouze na 0, protože v každé buňce je pouze jedna hodnota.
Znak za dvojtečku (B v obecném příkladu) určuje formát, ve kterém se má hodnota zobrazit. Následující tabulka uvádí běžné formáty.
| Formát znaku | Description |
|---|---|
C |
Zobrazí číselné hodnoty ve formátu měny. |
D |
Zobrazí číselné hodnoty v desítkovém formátu. |
E |
Zobrazí číselné hodnoty ve vědeckém (exponenciálním) formátu. |
F |
Zobrazí číselné hodnoty v pevném formátu. |
G |
Zobrazí číselné hodnoty v obecném formátu. |
N |
Zobrazí číselné hodnoty v číselném formátu. |
X |
Zobrazí číselné hodnoty v šestnáctkovém formátu. |
Poznámka:
Formátový znak nerozlišuje malá a velká písmena, s výjimkou Xznaků, které zobrazují šestnáctkové znaky v zadaném případě.
Hodnota za znakem formátu (xx v obecném příkladu) určuje počet platných číslic nebo desetinných míst, která se mají zobrazit.
Následující tabulka obsahuje příklady formátování řetězců a výsledků. Předpokládá standardní nastavení angličtiny.
| Číselná hodnota | Formátovací řetězec | Výsledek |
|---|---|---|
| 12345.6789 | {0:C} | \$12,345,68 |
| -12345.6789 | {0:C} | (\$12 345,68) |
| 12345 | {0:D} | 12345 |
| 12345 | {0:D8} | 00012345 |
| 12345.6789 | {0:E} | 1234568E+004 |
| 12345.6789 | {0:E10} | 1.2345678900E+004 |
| 12345.6789 | {0:F} | 12345.68 |
| 12345.6789 | {0:F0} | 12346 |
| 12345.6789 | {0:G} | 12345.6789 |
| 123456789 | {0:G7} | 1.234568E8 |
| 12345.6789 | {0:N} | 12,345.68 |
| 123456789 | {0:N4} | 123,456,789.0000 |
| 12345.6789 | "Celkem: {0:C}" | Celkem: \$12345.68 |
Další informace o formátování řetězců naleznete v tématu Typy formátování.
Hodnota této vlastnosti je uložena ve stavu zobrazení.
Tuto vlastnost nelze nastavit motivy ani motivy šablon stylů. Další informace najdete v tématu ThemeableAttribute a ASP.NET Motivy a skiny.
Platí pro
Viz také
- typy formátování v rozhraní .NET
