ListControl.DataTextFormatString Eigenschaft

Definition

Ruft die Formatierungszeichenfolge ab, mit der die Anzeige der mit dem Listensteuerelement verbundenen Daten gesteuert wird, oder legt diese fest.Gets or sets the formatting string used to control how data bound to the list control is displayed.

public:
 virtual property System::String ^ DataTextFormatString { System::String ^ get(); void set(System::String ^ value); };
[System.Web.UI.Themeable(false)]
public virtual string DataTextFormatString { get; set; }
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.The formatting string for data bound to the control. Der Standardwert ist Emptysein.The default value is Empty.

Attribute

Hinweise

Verwenden Sie DataTextFormatString die-Eigenschaft, um ein benutzerdefiniertes Anzeige Format der Elemente in einem Listen Steuerelement bereitzustellen.Use the DataTextFormatString property to provide a custom display format the items in a list control.

Die Datenformat Zeichenfolge besteht aus zwei Teilen, getrennt durch einen Doppelpunkt, in A der Bxx Form {:}.The data format string consists of two parts, separated by a colon, in the form { A : Bxx }. Beispielsweise würde die Formatierungs {0:F2} Zeichenfolge die Zelle formatieren, um eine fester Punkt Zahl mit zwei Dezimalstellen anzuzeigen.For example, the formatting string {0:F2} would format the cell to display a fixed point number with two decimal places.

Hinweis

Die gesamte Zeichenfolge muss in geschweifte Klammern eingeschlossen werden, um anzugeben, dass es sich um eine Format Zeichenfolge und keine LiteralzeichenThe entire string must be enclosed in braces to indicate that it is a format string and not a literal string. Text außerhalb der geschweiften Klammern wird als Literaltext angezeigt.Any text outside the braces is displayed as literal text.

Der Wert vor dem DoppelpunktA (im allgemeinen Beispiel) gibt den Parameter Index in einer Null basierten Liste von Parametern an.The value before the colon (A in the general example) specifies the parameter index in a zero-based list of parameters.

Hinweis

Dieser Wert kann nur auf 0 festgelegt werden, da in jeder Zelle nur ein Wert vorhanden ist.This value can only be set to 0 because there is only one value in each cell.

Das Zeichen nach dem DoppelpunktB (im allgemeinen Beispiel) gibt das Format an, in dem der Wert angezeigt werden soll.The character after the colon (B in the general example) specifies the format to display the value in. In der folgenden Tabelle sind die allgemeinen Formate aufgeführt.The following table lists the common formats.

Zeichen formatierenFormat character BeschreibungDescription
C Zeigt numerische Werte im Währungs Format an.Displays numeric values in currency format.
D Zeigt numerische Werte im Dezimal Format an.Displays numeric values in decimal format.
E Zeigt numerische Werte im wissenschaftlichen Format (exponentiell) an.Displays numeric values in scientific (exponential) format.
F Zeigt numerische Werte im Fixed-Format an.Displays numeric values in fixed format.
G Zeigt numerische Werte im allgemeinen Format an.Displays numeric values in general format.
N Zeigt numerische Werte im Zahlenformat an.Displays numeric values in number format.
X Zeigt numerische Werte im Hexadezimal Format an.Displays numeric values in hexadecimal format.

Hinweis

Bei dem Formatzeichen wird die Groß-/Kleinschreibung Xnicht beachtet, mit Ausnahme von, wodurch die hexadezimalen Zeichen im angegebenen Fall angezeigt werden.The format character is not case-sensitive, except for X, which displays the hexadecimal characters in the case specified.

Der Wert nach dem Formatzeichen (xx im allgemeinen Beispiel) gibt die Anzahl von signifikanten Ziffern oder Dezimalstellen an, die angezeigt werden sollen.The value after the format character (xx in the general example) specifies the number of significant digits or decimal places to display.

Die folgende Tabelle enthält Beispiele für das Formatieren von Zeichen folgen und die Ergebnisse.The following table contains examples of formatting strings and the results. Dabei werden standardmäßige englische Einstellungen vorausgesetzt.It assumes standard English settings.

Numerischer WertNumeric Value FormatzeichenfolgeFormat String ErgebnisResult
12345.678912345.6789 "{0:C}""{0:C}" $12,345.68$12,345.68
-12345.6789-12345.6789 "{0:C}""{0:C}" ($12,345.68)($12,345.68)
1234512345 "{0:D}""{0:D}" 1234512345
1234512345 "{0:D8}""{0:D8}" 0001234500012345
12345.678912345.6789 "{0:E}""{0:E}" 1234568E+0041234568E+004
12345.678912345.6789 "{0:E10}""{0:E10}" 1.2345678900 E + 0041.2345678900E+004
12345.678912345.6789 "{0:F}""{0:F}" 12345.6812345.68
12345.678912345.6789 "{0:F0}""{0:F0}" 1234612346
12345.678912345.6789 "{0:G}""{0:G}" 12345.678912345.6789
123456789123456789 "{0:G7}""{0:G7}" 1.234568E81.234568E8
12345.678912345.6789 "{0:N}""{0:N}" 12,345.6812,345.68
123456789123456789 "{0:N4}""{0:N4}" 123,456,789.0000123,456,789.0000
12345.678912345.6789 "Gesamt: {0:C}""Total: {0:C}" Gesamt: $12345,68Total: $12345.68

Weitere Informationen zum Formatieren von Zeichenfolgen finden Sie unter Formatierungstypen.For more information on formatting strings, see Formatting Types.

Der Wert dieser Eigenschaft wird im Ansichts Zustand gespeichert.The value of this property is stored in view state.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden.This property cannot be set by themes or style sheet themes. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Gilt für:

Siehe auch