Udostępnij za pośrednictwem

BoundField.DataFormatString Właściwość

  • Odwołanie

Definicja

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

Pobiera lub ustawia ciąg określający format wyświetlania dla wartości pola.

public:
 virtual property System::String ^ DataFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataFormatString { get; set; }
member this.DataFormatString : string with get, set
Public Overridable Property DataFormatString As String

Wartość właściwości

String

Ciąg formatowania określający format wyświetlania dla wartości pola. Wartość domyślna to pusty ciąg (""), który wskazuje, że do wartości pola nie zastosowano żadnego specjalnego formatowania.

Przykłady

Projekt witryny sieci Web programu Visual Studio z kodem źródłowym jest dostępny do dołączenia do tego tematu: Pobierz.

W poniższym przykładzie pokazano, jak za pomocą DataFormatString właściwości określić niestandardowy format wyświetlania wartości pola.

W poniższym przykładzie przedstawiono jeden wiersz danych wyjściowych utworzonych w tym przykładzie.

ProductID Nazwa Productnumber Listprice Waga ModifiedDate
000680 HL Road Frame - Black, 58 #FR-R92B-58 $1,431.50 1016.040 3/11/2004

Uwagi

Użyj właściwości , DataFormatString aby określić niestandardowy format wyświetlania dla wartości wyświetlanych w BoundField obiekcie. DataFormatString Jeśli właściwość nie jest ustawiona, wartość pola jest wyświetlana bez specjalnego formatowania.

Uwaga

W wersjach ASP.NET starszych niż 3.5 należy ustawić HtmlEncode właściwość na false , aby formatować pola, które nie są typami danych ciągów. W przeciwnym razie wartość pola jest konwertowana na ciąg do domyślnej metody konwersji przed zastosowaniem ciągu formatu przechowywanego DataFormatString we właściwości.

Domyślnie ciąg formatowania jest stosowany do wartości pola tylko wtedy, gdy kontrolka powiązana z danymi zawierająca BoundField obiekt jest w trybie tylko do odczytu. Aby zastosować ciąg formatowania do wartości pól w trybie edycji, ustaw ApplyFormatInEditMode właściwość na true.

Ciąg formatowania może być dowolnym ciągiem literału i zwykle zawiera symbol zastępczy wartości pola. Na przykład w ciągu Item Value: {0}formatowania wartość pola jest zastępowana symbolem {0} zastępczym, gdy ciąg jest wyświetlany w BoundField obiekcie. Pozostała część ciągu formatowania jest wyświetlana jako tekst literału.

Jeśli ciąg formatowania nie zawiera symbolu zastępczego, tylko sam ciąg formatowania jest uwzględniony w ostatnim tekście wyświetlania (wartość pola ze źródła danych nie jest uwzględniona). Jeśli symbol zastępczy jest 0 (zero) ujęty w nawiasy klamrowe, jak pokazano w poprzednim przykładzie, wartość pola jest konwertowana na ciąg do domyślnej metody. Możesz dołączyć do zera ciąg określający sposób formatowania wartości pola. Na przykład symbol zastępczy {0:C} pola liczbowego określa, że wartość pola powinna zostać przekonwertowana na format waluty.

Formatowanie jest stosowane przy użyciu Format metody . Liczba, która jest zgodna z nawiasem klamrowym po lewej stronie, jest częścią składni używanej przez tę metodę i wskazuje, której z serii wartości należy użyć symbolu zastępczego. Ponieważ w każdej komórce istnieje tylko jedna wartość pola, liczba, która następuje po lewym nawiasie klamrowym, może być ustawiona tylko na 0.

W poniższej tabeli wymieniono standardowe znaki formatu dla pól liczbowych. Te znaki formatu nie są uwzględniane w wielkości liter, z wyjątkiem Xznaków szesnastkowy, w których określono znaki szesnastkowe. Można dołączyć liczbę do większości znaków formatu, aby określić liczbę cyfr znaczących lub miejsc dziesiętnych, które mają być wyświetlane.

Uwaga

W większości przypadków formatowanie zależy od ustawienia kultury serwera. Przykłady dotyczą ustawienia kultury .en-US

Formatuj znak Opis Przykład
C lub c Wyświetla wartości liczbowe w formacie waluty. Można określić liczbę miejsc dziesiętnych. Formacie: {0:C}

123,456 -> 123,46 USD

Formacie: {0:C3}

123,456 -> 123,456 USD
D lub d Wyświetla wartości całkowite w formacie dziesiętny. Możesz określić liczbę cyfr. (Chociaż typ jest określany jako "dziesiętny", liczby są sformatowane jako liczby całkowite). Formacie: {0:D}

1234 -> 1234

Formacie: {0:D6}

1234 —> 001234
E lub e Wyświetla wartości liczbowe w formacie naukowym (wykładniczym). Można określić liczbę miejsc dziesiętnych. Formacie: {0:E}

1052.032912756 -> 1.052033E+0033

Formacie: {0:E2}

-1052.032912756 -> -1.05e+003
F lub f Wyświetla wartości liczbowe w stałym formacie. Można określić liczbę miejsc dziesiętnych. Formacie: {0:F}

1234.567 -> 1234.57

Formacie: {0:F3}

1234.567 -> 1234.567
G lub g Wyświetla wartości liczbowe w ogólnym formacie (najbardziej kompaktowanie notacji stałej lub naukowej). Możesz określić liczbę cyfr znaczących. Formacie: {0:G}

-123.456 -> -123.456

Formacie: {0:G2}

-123.456 -> -120
N lub n Wyświetla wartości liczbowe w formacie liczbowym (w tym separatory grup i opcjonalny znak ujemny). Można określić liczbę miejsc dziesiętnych. Formacie: {0:N}

1234.567 -> 1234.57

Formacie: {0:N4}

1234.567 -> 1 234.5670
P lub p Wyświetla wartości liczbowe w formacie procentowym. Można określić liczbę miejsc dziesiętnych. Formacie: {0:P}

1 –> 100,00%

Formacie: {0:P1}

.5 –> 50,0%
R lub r Wyświetla Singlewartości , Doublelub BigInteger w formacie zaokrąglonej podróży. Formacie: {0:R}

123456789.12345678 -> 123456789.12345678
X lub x Wyświetla wartości całkowite w formacie szesnastkowym. Możesz określić liczbę cyfr. Formacie: {0:X}

255 -> FF

Formacie: {0:x4}

255 -> 00ff

Aby uzyskać więcej informacji i przykłady pokazujące formatowanie innych wartości kultury, zobacz Standardowe ciągi formatu liczbowego. Można również utworzyć niestandardowe ciągi formatu liczbowego. Aby uzyskać więcej informacji, zobacz Niestandardowe ciągi formatu liczbowego.

W poniższej tabeli wymieniono znaki formatu pól DateTime . Większość tych specyfikacji formatowania powoduje inne dane wyjściowe w zależności od ustawień kultury. Przykłady dotyczą DateTime wartości 6/15/2009 1:45:30 z ustawieniem kultury .en-US

Formatuj znak Opis Przykład
d Wzorzec daty krótkiej. Formacie: {0:d}

15.06.2009 13:45:30 –> 15.15.2009
D Wzorzec daty długiej. Formacie: {0:D}

15.06.2009 13:45:30 –>poniedziałek, 15 czerwca 2009 r.
f Wzorzec pełnej daty/godziny (godzina krótka). Formacie: {0:f}

15.06.2009 13:45:30 –> poniedziałek, 15 czerwca 2009 13:45
F Wzorzec pełnej daty/godziny (godzina długa). Formacie: {0:F}

15.06.2009 13:45:30 –> poniedziałek, 15 czerwca 2009 13:45:30
g Wzorzec ogólnej daty/godziny (godzina krótka). Formacie: {0:g}

15.06.2009 13:45:30 -> 15.15.2009 13:45
G Wzorzec ogólnej daty/godziny (godzina długa). Formacie: {0:G}

15.06.2009 13:45:30 –> 15.15.2009 13:45:30
M lub m Wzorzec miesiąc/dzień. Formacie: {0:M}

15.06.2009 13:45:30 –> 15 czerwca
O lub o Wzorzec dwustronnej konwersji data/godzina. Formacie: {0:o}

6/15/2009 1:45:30–> 2009-06-15T13:45:30.0900000
R lub r Wzorzec RFC1123 (aby uzyskać informacje, zobacz DateTimeFormatInfo.RFC1123Pattern). Formacie: {0:R}

15.06.2009 13:45:30 -> Mon, 15 Jun 2009 20:45:30 GMT
s Wzorzec sortowalnej daty/godziny. Formacie: {0:s}

6/15/2009 1:45:30–> 2009-06-15T13:45:30
t Wzorzec godziny krótkiej. Formacie: {0:t}

15.06.2009 13:45:30–> 13:45
T Wzorzec godziny długiej. Formacie: {0:T}

15.06.2009 13:45:30–> 13:45:30
u Wzorzec uniwersalnej sortowalnej daty/godziny. Formacie: {0:u}

6/15/2009 1:45:30–> 2009-06-15 20:45:30Z
U Wzorzec uniwersalnej pełnej daty/godziny. Formacie: {0:U}

15.06.2009 13:45:30 –> poniedziałek, 15 czerwca 2009 18:45:30
Y lub y Wzorzec roku i miesiąca. Formacie: {0:Y}

15.06.2009 13:45:30 –> czerwiec 2009 r.

Aby uzyskać więcej informacji i przykładów pokazujących formatowanie innych wartości kultury, zobacz Standardowe ciągi formatu daty i godziny. Można również utworzyć niestandardowe ciągi formatu daty i godziny. Aby uzyskać więcej informacji, zobacz Niestandardowe ciągi formatu daty i godziny.

Dotyczy

Zobacz też