ListControl.DataTextFormatString Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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

String

Die Formatierungszeichenfolge für Daten, die mit dem Steuerelement verbunden sind. Der Standardwert ist Empty.

Attribute
ThemeableAttribute

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.

Gilt für:

Weitere Informationen