ListControl.DataTextFormatString Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Formatierungszeichenfolge ab, die verwendet wird, um zu steuern, wie Daten, die an das Listensteuerelement gebunden sind, angezeigt werden, oder legt diese fest.
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 StringEigenschaftswert
Die Formatierungszeichenfolge für Daten, die an das Steuerelement gebunden sind. Der Standardwert ist Empty.
- Attribute
Hinweise
Verwenden Sie die DataTextFormatString Eigenschaft, um ein benutzerdefiniertes Anzeigeformat für die Elemente in einem Listensteuerelement bereitzustellen.
Die Datenformatzeichenfolge besteht aus zwei Teilen, getrennt durch einen Doppelpunkt, in der Form { A : Bxx }. Beispielsweise würde die Formatierungszeichenfolge {0:F2} die Zelle so formatieren, dass eine feste Punktzahl mit zwei Dezimalstellen angezeigt wird.
Hinweis
Die gesamte Zeichenfolge muss in geschweifte Klammern eingeschlossen werden, um anzugeben, dass es sich um eine Formatzeichenfolge und nicht um eine Literalzeichenfolge handelt. Text außerhalb der geschweiften Klammern wird als Literaltext angezeigt.
Der Wert vor dem Doppelpunkt (A im allgemeinen Beispiel) gibt den Parameterindex in einer nullbasierten Liste von Parametern an.
Hinweis
Dieser Wert kann nur auf 0 festgelegt werden, da in jeder Zelle nur ein Wert vorhanden ist.
Das Zeichen hinter dem Doppelpunkt (B im allgemeinen Beispiel) gibt das Format an, in dem der Wert angezeigt werden soll. In der folgenden Tabelle sind die allgemeinen Formate aufgeführt.
| Zeichen formatieren | Beschreibung |
|---|---|
C |
Zeigt numerische Werte im Währungsformat an. |
D |
Zeigt numerische Werte im Dezimalformat an. |
E |
Zeigt numerische Werte im wissenschaftlichen (exponentiellen) Format an. |
F |
Zeigt numerische Werte im festen Format an. |
G |
Zeigt numerische Werte im allgemeinen Format an. |
N |
Zeigt numerische Werte im Zahlenformat an. |
X |
Zeigt numerische Werte im Hexadezimalformat an. |
Hinweis
Bei dem Formatzeichen wird die Groß-/Kleinschreibung nicht beachtet, mit Ausnahme Xder Groß-/Kleinschreibung, die die hexadezimalen Zeichen im angegebenen Fall anzeigt.
Der Wert nach dem Formatzeichen (xx im allgemeinen Beispiel) gibt die Anzahl der anzuzeigenden signifikanten Ziffern oder Dezimalstellen an.
Die folgende Tabelle enthält Beispiele für Formatierungszeichenfolgen und die Ergebnisse. Es wird davon ausgegangen, dass standardeinstellungen für Englisch verwendet werden.
| Numerischer Wert | Format-String | Ergebnis |
|---|---|---|
| 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 | "Total: {0:C}" | Gesamt: \$12345,68 |
Weitere Informationen zum Formatieren von Zeichenfolgen finden Sie unter "Formatierungstypen".
Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.
Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET Designs und Skins.
