Sdílet prostřednictvím


ListControl.DataTextFormatString Vlastnost

Definice

Získá nebo nastaví formátovací řetězec použitý k řízení způsobu zobrazení dat svázaných se seznamem ovládací prvek.

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, set
Public Overridable Property DataTextFormatString As String

Hodnota vlastnosti

Formátovací řetězec pro data vázaná na ovládací prvek. Výchozí hodnota je Empty.

Atributy

Poznámky

DataTextFormatString Vlastnost slouží k zadání vlastního formátu zobrazení položek v ovládacím prvku seznamu.

Řetězec formátu dat se skládá ze dvou částí oddělených dvojtečka ve tvaru { A : Bxx }. Formátovací řetězec {0:F2} například naformátuje 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, a ne o řetězec literálu. Jakýkoli text mimo závorky se zobrazí jako literálový text.

Hodnota před dvojtečka (A v obecném příkladu) určuje index parametru v seznamu parametrů založených na nule.

Poznámka

Tato hodnota může být nastavena pouze na hodnotu 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. V následující tabulce jsou uvedené 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 ve formátu čísel.
X Zobrazí číselné hodnoty v šestnáctkovém formátu.

Poznámka

Formátovaný znak nerozlišuje velká a malá písmena, s výjimkou Xznaku , který zobrazuje šestnáctkové znaky v zadaném případu.

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átovat řetězec Výsledek
12345.6789 "{0:C}" 12 345,68 Kč
-12345.6789 "{0:C}" (12 345,68 Kč)
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 Kč

Další informace o formátování řetězců najdete v tématu Typy formátování.

Hodnota této vlastnosti je uložena ve stavu zobrazení.

Tuto vlastnost nelze nastavit pomocí motivů nebo šablon stylů. Další informace najdete v tématu ThemeableAttribute a ASP.NET motivy a vzhledy.

Platí pro

Viz také