BoundField.DataFormatString Eigenschaft

  • Referenz

Definition

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

Ruft die Zeichenfolge ab, die das Anzeigeformat für den Wert des Felds angibt, oder legt diese fest.

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, set
Public Overridable Property DataFormatString As String

Eigenschaftswert

String

Eine Formatierungszeichenfolge, die das Anzeigeformat für den Wert des Felds angibt. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass keine besondere Formatierung auf den Feldwert angewendet wird.

Beispiele

Ein Visual Studio Websiteprojekt mit Quellcode ist verfügbar, um dieses Thema zu begleiten: Herunterladen.

Das folgende Beispiel zeigt, wie Sie mithilfe der DataFormatString Eigenschaft ein benutzerdefiniertes Anzeigeformat für die Werte eines Felds angeben.

Das folgende Beispiel zeigt eine Zeile der Ausgabe, die von diesem Beispiel erstellt wird.

ProductID Name ProductNumber ListPrice Weight ModifiedDate
000680 HL Road Frame - Black, 58 #FR-R92B-58 $1,431.50 1016.040 3/11/2004

Hinweise

Verwenden Sie die DataFormatString Eigenschaft, um ein benutzerdefiniertes Anzeigeformat für die Werte anzugeben, die im BoundField Objekt angezeigt werden. Wenn die Eigenschaft nicht festgelegt ist, wird der DataFormatString Wert des Felds ohne spezielle Formatierung angezeigt.

Hinweis

In Versionen von ASP.NET früher als 3.5 müssen Sie die Eigenschaft false festlegen, um Felder zu formatieren, die HtmlEncode keine Zeichenfolgendatentypen sind. Andernfalls wird der Feldwert durch die Standardkonvertierungsmethode in eine Zeichenfolge konvertiert, bevor die in der DataFormatString Eigenschaft gespeicherte Formatzeichenfolge angewendet wird.

Standardmäßig wird die Formatierungszeichenfolge nur auf den Feldwert angewendet, wenn das datengebundene Steuerelement, das das BoundField Objekt enthält, im schreibgeschützten Modus ist. Um die Formatierungszeichenfolge auf Feldwerte während des Bearbeitungsmodus anzuwenden, legen Sie die ApplyFormatInEditMode Eigenschaft auf true.

Die Formatierungszeichenfolge kann eine beliebige Literalzeichenfolge sein und enthält in der Regel einen Platzhalter für den Wert des Felds. Beispielsweise wird der Wert des Felds in der Formatierungszeichenfolge durch den {0} Platzhalter ersetzt, wenn die Zeichenfolge Item Value: {0}im BoundField Objekt angezeigt wird. Der Rest der Formatierungszeichenfolge wird als Literaltext angezeigt.

Wenn die Formatierungszeichenfolge keinen Platzhalter enthält, wird nur die Formatierungszeichenfolge selbst im endgültigen Anzeigetext enthalten (der Wert des Felds aus der Datenquelle ist nicht enthalten). Wenn der Platzhalter eine 0 (Null) ist, die in Klammern eingeschlossen ist, wie im vorherigen Beispiel dargestellt, wird der Feldwert in eine Zeichenfolge mit der Standardmethode konvertiert. Sie können an die Null anfügen, die angibt, wie der Feldwert formatiert werden soll. Der Platzhalter {0:C} für ein numerisches Feld gibt beispielsweise an, dass der Wert des Felds in ein Währungsformat konvertiert werden soll.

Die Formatierung wird mithilfe der Format Methode angewendet. Die Zahl, die der linken geschweiften Klammer folgt, ist Teil der Syntax, die von dieser Methode verwendet wird, und gibt an, welche einer der Werte, die der Platzhalter verwenden sollte. Da nur ein Feldwert in jeder Zelle vorhanden ist, kann die Zahl, die der linken geschweiften Klammer folgt, nur auf 0 festgelegt werden.

In der folgenden Tabelle sind die Standardformatzeichen für numerische Felder aufgeführt. Diese Formatzeichen sind nicht groß- und kleinschreibungsgeschützt, mit Ausnahme Xvon Hexadezimalzeichen im angegebenen Fall. Sie können eine Zahl an die meisten Formatzeichen anfügen, um anzugeben, wie viele signifikante Ziffern oder Dezimalstellen angezeigt werden sollen.

Hinweis

In den meisten Fällen hängt die Formatierung von der Kultureinstellung des Servers ab. Die Beispiele sind für eine Kultureinstellung von en-US.

Zeichen formatieren BESCHREIBUNG Beispiel
C oder c Zeigt numerische Werte im Währungsformat an. Sie können die Anzahl der Dezimalstellen angeben. Format: {0:C}

123.456 -> $123.46

Format: {0:C3}

123.456 -> $123.456
D oder d Zeigt ganzzahlige Werte im Dezimalformat an. Sie können die Anzahl der Ziffern angeben. (Obwohl der Typ als "Dezimal" bezeichnet wird, werden die Zahlen als ganze Zahlen formatiert.) Format: {0:D}

1234 -> 1234

Format: {0:D6}

1234 -> 001234
E oder e Zeigt numerische Werte im wissenschaftlichen (exponentiellen) Format an. Sie können die Anzahl der Dezimalstellen angeben. Format: {0:E}

1052.0329112756 -> 1.052033E+003

Format: {0:E2}

-1052.0329112756 -> -1,05e+003
F oder f Zeigt numerische Werte im festen Format an. Sie können die Anzahl der Dezimalstellen angeben. Format: {0:F}

1234.567 -> 1234.57

Format: {0:F3}

1234.567 -> 1234.567
G oder g Zeigt numerische Werte im allgemeinen Format an (die kompakteste Schreibweise von festen Punkten oder wissenschaftlicher Notation). Sie können die Anzahl der signifikanten Ziffern angeben. Format: {0:G}

-123.456 -> -123.456

Format: {0:G2}

-123.456 -> -120
N oder n Zeigt numerische Werte im Zahlenformat an (einschließlich Gruppentrennzeichen und optionales negatives Zeichen). Sie können die Anzahl der Dezimalstellen angeben. Format: {0:N}

1234.567 -> 1,234.57

Format: {0:N4}

1234.567 -> 1,234.5670
P oder p Zeigt numerische Werte im Prozentformat an. Sie können die Anzahl der Dezimalstellen angeben. Format: {0:P}

1 -> 100.00%

Format: {0:P1}

.5 -> 50.0%
R oder r Zeigt Single, Doubleoder BigInteger Werte im Roundtrip-Format an. Format: {0:R}

123456789.12345678 -> 123456789.12345678
X oder x Zeigt ganzzahlige Werte im Hexadezimalformat an. Sie können die Anzahl der Ziffern angeben. Format: {0:X}

255 -> FF

Format: {0:x4}

255 -> 00ff

Weitere Informationen und Beispiele, die Formatierungen für andere Kulturwerte anzeigen, finden Sie unter Standard-Numerische Formatzeichenfolgen. Sie können auch benutzerdefinierte numerische Formatzeichenfolgen erstellen. Weitere Informationen finden Sie unter Benutzerdefinierte Zahlenformatzeichenfolgen.

In der folgenden Tabelle sind Formatzeichen für DateTime Felder aufgeführt. Die meisten dieser Formatierungsspezifikationen führen je nach Kultureinstellungen zu einer anderen Ausgabe. Die Beispiele sind für einen DateTime Wert von 6/15/2009 1:45:30 Uhr mit einer Kultureinstellung von en-US.

Zeichen formatieren BESCHREIBUNG Beispiel
d Kurzes Datumsmuster. Format: {0:d}

6.15.2009 1:45:30 Uhr -> 6.15.2009
D Langes Datumsmuster. Format: {0:D}

6.15.2009 1:45:30 Uhr ->Montag, 15. Juni 2009
f Vollständiges Datums-/Zeitmuster (kurze Zeit). Format: {0:f}

6.15.2009 1:45:30 Uhr -> Montag, 15. Juni 2009 1:45 Uhr
F Vollständiges Datums-/Zeitmuster (lange Zeit). Format: {0:F}

6/15/2009 1:45:30 Uhr -> Montag, 15. Juni 2009 1:45:30 Uhr
g Allgemeines Datums-/Zeitmuster (kurze Zeit). Format: {0:g}

6.15.2009 1:45:30 Uhr -> 6.15.2009 1:45 Uhr
G Allgemeines Datums-/Zeitmuster (lange Zeit). Format: {0:G}

6.15.2009 1:45:30 Uhr -> 6.15.2009 1:45:30 Uhr
M oder m Monatstagmuster. Format: {0:M}

6.15.2009 1:45:30 Uhr -> 15. Juni
O oder o Zurückkonvertieren von Datums-/Zeitmuster. Format: {0:o}

15.06.2009 13:45:30 -> 2009-06-15T13:45:30.0900000
R oder r RFC1123-Muster (Informationen finden Sie unter DateTimeFormatInfo.RFC1123Pattern). Format: {0:R}

6/15/2009 1:45:30 PM -> Mon, 15 Jun 2009 20:45:30 GMT
s Sortierbares Datums-/Zeitmuster. Format: {0:s}

6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30
t Kurzes Zeitmuster. Format: {0:t}

6.15.2009 1:45:30 Uhr -> 1:45 Uhr
T Langes Zeitmuster. Format: {0:T}

6.15.2009 1:45:30 Uhr -> 1:45:30 Uhr
u Universelles, sortierbares Datums-/Zeitmuster. Format: {0:u}

6/15/2009 1:45:30 PM -> 2009-06-15 20:45:30Z
U Universelles Datums-/Zeitmuster (Koordinierte Weltzeit). Format: {0:U}

6/15/2009 1:45:30 Uhr -> Montag, 15. Juni 2009 8:45:30 Uhr
Y oder y Jahr-Monat-Muster. Format: {0:Y}

6.15.2009 1:45:30 Uhr -> Juni 2009

Weitere Informationen und Beispiele, die Formatierungen für andere Kulturwerte anzeigen, finden Sie unter Standarddatums- und Uhrzeitformatzeichenfolgen. Sie können auch benutzerdefinierte Datums- und Uhrzeitformatzeichenfolgen erstellen. Weitere Informationen finden Sie unter Benutzerdefinierte Datums- und Uhrzeitformatzeichenfolgen.

Gilt für

Siehe auch