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, mit der die Anzeige der mit dem Listensteuerelement verbundenen Daten gesteuert wird, 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, set
Public Overridable Property DataTextFormatString As String
Eigenschaftswert
Die Formatierungszeichenfolge für Daten, die mit dem Steuerelement verbunden 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, im Format { 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. Jeder 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 nach dem Doppelpunkt (B
im allgemeinen Beispiel) gibt das Format an, in dem der Wert angezeigt werden soll. In der folgenden Tabelle sind die gängigen Formate aufgeführt.
Formatieren von Zeichen | 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
Beim Formatzeichen wird die Groß-/Kleinschreibung nicht beachtet, mit Ausnahme von X
, das die Hexadezimalzeichen in der angegebenen Groß-/Kleinschreibung 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 von englischen Standardeinstellungen ausgegangen.
Numerischer Wert | Formatzeichenfolge | 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 | "Gesamt: {0:C}" | Gesamt: 12345,68 USD |
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.