ListControl.DataTextFormatString Vlastnost

  • Reference

Definice

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

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

String

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

Atributy
ThemeableAttribute

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é