ListControl.DataTextFormatString Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia ciąg formatowania używany do kontrolowania sposobu wyświetlania danych powiązanych z kontrolką listy.

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

Wartość właściwości

String

Ciąg formatowania danych powiązany z kontrolką. Wartość domyślna to Empty.

Atrybuty
ThemeableAttribute

Uwagi

Użyj właściwości , DataTextFormatString aby podać niestandardowy format wyświetlania elementów w kontrolce listy.

Ciąg formatu danych składa się z dwóch części oddzielonych dwukropkiem w postaci { : ABxx }. Na przykład ciąg {0:F2} formatowania będzie formatować komórkę, aby wyświetlić stałą liczbę punktów z dwoma miejscami dziesiętnymi.

Uwaga

Cały ciąg musi być ujęty w nawiasy klamrowe, aby wskazać, że jest to ciąg formatu, a nie ciąg literału. Dowolny tekst poza nawiasami klamrowych jest wyświetlany jako tekst literału.

Wartość przed dwukropkiem (A w ogólnym przykładzie) określa indeks parametrów na liście parametrów opartych na zera.

Uwaga

Tę wartość można ustawić tylko na wartość 0, ponieważ w każdej komórce znajduje się tylko jedna wartość.

Znak po dwukropku (B w ogólnym przykładzie) określa format wyświetlania wartości. W poniższej tabeli wymieniono typowe formaty.

Formatuj znak Opis
C Wyświetla wartości liczbowe w formacie waluty.
D Wyświetla wartości liczbowe w formacie dziesiętny.
E Wyświetla wartości liczbowe w formacie naukowym (wykładniczym).
F Wyświetla wartości liczbowe w stałym formacie.
G Wyświetla wartości liczbowe w formacie ogólnym.
N Wyświetla wartości liczbowe w formacie liczbowym.
X Wyświetla wartości liczbowe w formacie szesnastkowym.

Uwaga

Znak formatu nie jest uwzględniany w wielkości liter, z wyjątkiem znaków szesnastkowej, z wyjątkiem Xznaków szesnastkowej w określonym przypadku.

Wartość po znaku formatu (xx w ogólnym przykładzie) określa liczbę cyfr znaczących lub miejsc dziesiętnych do wyświetlenia.

Poniższa tabela zawiera przykłady ciągów formatowania i wyników. Zakłada się, że standardowe ustawienia języka angielskiego.

Wartość liczbowa Formatowanie ciągu Wynik
12345.6789 "{0:C}" 12 345,68 USD
-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 "Suma: {0:C}" Suma: $12345.68

Aby uzyskać więcej informacji na temat formatowania ciągów, zobacz Formatting Types (Typy formatowania).

Wartość tej właściwości jest przechowywana w stanie widoku.

Nie można ustawić tej właściwości według motywów ani motywów arkusza stylów. Aby uzyskać więcej informacji, zobacz ThemeableAttributei ASP.NET Motywy i skóry.

Dotyczy

Zobacz też