ListControl.DataTextFormatString 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 formateringssträngen som används för att styra hur data som är bundna till listkontrollen visas.
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 StringEgenskapsvärde
Formateringssträngen för data som är bundna till kontrollen. Standardvärdet är Empty.
- Attribut
Kommentarer
Använd egenskapen DataTextFormatString för att ange ett anpassat visningsformat för objekten i en listkontroll.
Dataformatsträngen består av två delar, avgränsade med ett kolon, i formatet { A : Bxx }. Formateringssträngen {0:F2} skulle till exempel formatera cellen så att den visar ett fast punktnummer med två decimaler.
Note
Hela strängen måste omges av klammerparenteser för att indikera att det är en formatsträng och inte en literalsträng. All text utanför klammerparenteserna visas som literaltext.
Värdet före kolonet (A i det allmänna exemplet) anger parameterindexet i en nollbaserad lista med parametrar.
Note
Det här värdet kan bara anges till 0 eftersom det bara finns ett värde i varje cell.
Tecknet efter kolonet (B i det allmänna exemplet) anger formatet som värdet ska visas i. I följande tabell visas de vanliga formaten.
| Formattecken | Description |
|---|---|
C |
Visar numeriska värden i valutaformat. |
D |
Visar numeriska värden i decimalformat. |
E |
Visar numeriska värden i vetenskapligt (exponentiellt) format. |
F |
Visar numeriska värden i fast format. |
G |
Visar numeriska värden i allmänt format. |
N |
Visar numeriska värden i talformat. |
X |
Visar numeriska värden i hexadecimalt format. |
Note
Formattecknet är inte skiftlägeskänsligt, förutom X, som visar hexadecimala tecken i det angivna fallet.
Värdet efter formattecknet (xx i det allmänna exemplet) anger antalet signifikanta siffror eller decimaler som ska visas.
Följande tabell innehåller exempel på formateringssträngar och resultat. Det förutsätter engelska standardinställningar.
| Numeriskt värde | Formatsträng | Result |
|---|---|---|
| 12345.6789 | {0:C} | \$12,345.68 |
| -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 | "Totalt: {0:C}" | Totalt: \$12345.68 |
Mer information om formateringssträngar finns i Formateringstyper.
Värdet för den här egenskapen lagras i visningstillstånd.
Den här egenskapen kan inte anges med teman eller formatmallsteman. Mer information finns i ThemeableAttribute and ASP.NET Themes and Skins.
