BoundField.DataFormatString Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger strängen som anger visningsformatet för fältets värde.
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, setPublic Overridable Property DataFormatString As StringEgenskapsvärde
En formateringssträng som anger visningsformatet för fältets värde. Standardvärdet är en tom sträng (""), som anger att ingen särskild formatering tillämpas på fältvärdet.
Kommentarer
Använd egenskapen DataFormatString för att ange ett anpassat visningsformat för de värden som visas i BoundField objektet. Om egenskapen DataFormatString inte har angetts visas fältets värde utan någon särskild formatering.
Note
I versioner av ASP.NET tidigare än 3.5 måste du ange egenskapen HtmlEncode till false för att formatera fält som inte är strängdatatyper. Annars konverteras fältvärdet till en sträng som standardkonverteringsmetod innan formatsträngen DataFormatString som lagras i egenskapen tillämpas.
Som standard tillämpas formateringssträngen endast på fältvärdet när den databundna kontroll som innehåller BoundField objektet är i skrivskyddat läge. Om du vill tillämpa formateringssträngen på fältvärden i redigeringsläge anger du ApplyFormatInEditMode egenskapen till true.
Formateringssträngen kan vara valfri literalsträng och innehåller vanligtvis en platshållare för fältets värde. I formateringssträngen Item Value: {0}ersätts till exempel fältets värde med {0} platshållaren när strängen visas i BoundField objektet. Resten av formateringssträngen visas som literaltext.
Om formateringssträngen inte innehåller någon platshållare inkluderas endast själva formateringssträngen i den slutliga visningstexten (fältets värde från datakällan ingår inte). Om platshållaren är en 0 (noll) omgiven av klammerparenteser som visas i föregående exempel konverteras fältvärdet till en sträng som standardmetod. Du kan lägga till en sträng som anger hur fältvärdet ska formateras till noll. Platshållaren {0:C} för ett numeriskt fält anger till exempel att värdet för fältet ska konverteras till ett valutaformat.
Formatering används med hjälp Format av metoden . Talet som följer den vänstra klammerparentesen är en del av den syntax som används av metoden och anger vilket av en serie värden som platshållaren ska använda. Eftersom det bara finns ett fältvärde i varje cell kan talet som följer den vänstra klammerparentesen bara anges till 0.
I följande tabell visas standardformattecken för numeriska fält. Dessa formattecken är inte skiftlägeskänsliga, förutom X, som visar hexadecimala tecken i det angivna fallet. Du kan lägga till ett tal i de flesta formattecken för att ange hur många signifikanta siffror eller decimaler du vill visa.
Note
I de flesta fall beror formateringen på serverns kulturinställning. Exemplen är för en kulturinställning med en-US.
| Formattecken | Description | Example |
|---|---|---|
C eller c |
Visar numeriska värden i valutaformat. Du kan ange antalet decimaler. | Format: {0:C}123.456 -> \$123.46 Format: {0:C3}123.456 -> \$123.456 |
D eller d |
Visar heltalsvärden i decimalformat. Du kan ange antalet siffror. (Även om typen kallas "decimal" formateras talen som heltal.) | Format: {0:D}1234 -> 1234 Format: {0:D6}1234 –> 001234 |
E eller e |
Visar numeriska värden i vetenskapligt (exponentiellt) format. Du kan ange antalet decimaler. | Format: {0:E}1052.0329112756 -> 1.052033E+003 Format: {0:E2}-1052.0329112756 -> -1.05e+003 |
F eller f |
Visar numeriska värden i fast format. Du kan ange antalet decimaler. | Format: {0:F}1234.567 -> 1234.57 Format: {0:F3}1234.567 -> 1234.567 |
G eller g |
Visar numeriska värden i allmänt format (den mest kompakta av antingen fast punkt eller vetenskaplig notation). Du kan ange antalet signifikanta siffror. | Format: {0:G}-123.456 -> -123.456 Format: {0:G2}-123.456 -> -120 |
N eller n |
Visar numeriska värden i talformat (inklusive gruppavgränsare och valfritt negativt tecken). Du kan ange antalet decimaler. | Format: {0:N}1234.567 -> 1,234.57 Format: {0:N4}1234.567 -> 1,234.5670 |
P eller p |
Visar numeriska värden i procentformat. Du kan ange antalet decimaler. | Format: {0:P}1–> 100,00% Format: {0:P1}0,5–> 50,0% |
R eller r |
Visar Single, Doubleeller BigInteger värden i tur och retur-format. |
Format: {0:R}123456789.12345678 -> 123456789.12345678 |
X eller x |
Visar heltalsvärden i hexadecimalt format. Du kan ange antalet siffror. | Format: {0:X}255 -> FF Format: {0:x4}255 -> 00ff |
Mer information och exempel som visar formatering för andra kulturvärden finns i Standard numeriska formatsträngar. Du kan också skapa anpassade numeriska formatsträngar. Mer information finns i Anpassade numeriska formatsträngar.
I följande tabell visas formattecken för DateTime fält. De flesta av dessa formateringsspecifikationer resulterar i olika utdata beroende på kulturinställningar. Exemplen är för värdet DateTime 2009-06-15 13:45:30 med kulturinställningen en-US.
| Formattecken | Description | Example |
|---|---|---|
d |
Kort datummönster. | Format: {0:d}2009-06-15 13:45:30–> 2009-06-15 |
D |
Långt datummönster. | Format: {0:D}2009-06-15 13:45:30 ->måndag 15 juni 2009 |
f |
Mönster för fullständigt datum/tid (kort tid). | Format: {0:f}2009-06-15 13:45:30–> måndag 15 juni 2009 13:45 |
F |
Fullständigt datum/tid-mönster (lång tid). | Format: {0:F}2009-06-15 13:45:30 –> måndag 15 juni 2009 13:45:30 |
g |
Allmänt datum/tid-mönster (kort tid). | Format: {0:g}2009-06-15 13:45:30–> 2009-06-15 13:45 |
G |
Allmänt datum/tid-mönster (lång tid). | Format: {0:G}2009-06-15 13:45:30–> 2009-06-15 13:45:30 |
M eller m |
Mönster för månad/dag. | Format: {0:M}2009-06-15 13:45:30–> 15 juni |
O eller o |
Datum-/tidsmönster för tur och retur. | Format: {0:o}2009-06-15 13:45:30–> 2009-06-15T13:45:30.0900000 |
R eller r |
RFC1123 mönster (mer information finns i DateTimeFormatInfo.RFC1123Pattern). | Format: {0:R}2009-06-15 13:45:30 –> mån, 15 jun 2009 20:45:30 GMT |
s |
Sorterbart datum/tid-mönster. | Format: {0:s}2009-06-15 13:45:30–> 2009-06-15T13:45:30 |
t |
Kort tidsmönster. | Format: {0:t}2009-06-15 13:45:30–> 13:45 |
T |
Mönster för lång tid. | Format: {0:T}2009-06-15 13:45:30–> 13:45:30 |
u |
Universellt sorterbart datum/tid-mönster. | Format: {0:u}2009-06-15 13:45:30–> 2009-06-15 20:45:30Z |
U |
Universellt mönster för fullständigt datum/tid. | Format: {0:U}2009-06-15 13:45:30 –> måndag 15 juni 2009 20:45:30 |
Y eller y |
Mönster för årsmånad. | Format: {0:Y}2009-06-15 13:45:30 –> juni 2009 |
Mer information och exempel som visar formatering för andra kulturvärden finns i Formatsträngar för standarddatum och tid. Du kan också skapa anpassade datum- och tidsformatsträngar. Mer information finns i Anpassade datum- och tidsformatsträngar.
