ListControl.DataTextFormatString Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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, setPublic Overridable Property DataTextFormatString As StringWartość właściwości
Ciąg formatowania danych powiązany z kontrolką. Wartość domyślna to Empty.
- Atrybuty
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.
