ListControl.DataTextFormatString-Eigenschaft
Ruft die Formatierungszeichenfolge ab, mit der die Anzeige der mit dem Listensteuerelement verbundenen Daten gesteuert wird, oder legt diese fest.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<ThemeableAttribute(False)> _
Public Overridable Property DataTextFormatString As String
'Usage
Dim instance As ListControl
Dim value As String
value = instance.DataTextFormatString
instance.DataTextFormatString = value
[ThemeableAttribute(false)]
public virtual string DataTextFormatString { get; set; }
[ThemeableAttribute(false)]
public:
virtual property String^ DataTextFormatString {
String^ get ();
void set (String^ value);
}
/** @property */
public String get_DataTextFormatString ()
/** @property */
public void set_DataTextFormatString (String value)
public function get DataTextFormatString () : String
public function set DataTextFormatString (value : String)
Eigenschaftenwert
Die Formatierungszeichenfolge für Daten, die mit dem Steuerelement verbunden sind. Der Standardwert ist String.Empty.
Hinweise
Stellen Sie mithilfe der DataTextFormatString-Eigenschaft ein benutzerdefiniertes Anzeigeformat für die Elemente in einem Listensteuerelement bereit.
Die Zeichenfolge für das Datenformat besteht aus zwei durch Doppelpunkt getrennten Teilen der Form {A:Bxx}. Die Formatzeichenfolge {0:F2} formatiert die Zelle z. B. so, dass eine Festkommazahl mit zwei Dezimalstellen angezeigt wird.
Hinweis
Die gesamte Zeichenfolge muss in geschweiften Klammern stehen, die darauf hinweisen, dass es sich nicht um ein Zeichenfolgenliteral, sondern um eine Formatzeichenfolge handelt. Text, der sich nicht in den geschweiften Klammern befindet, wird stets als Literaltext angezeigt.
Der Wert vor dem Doppelpunkt (im Beispiel A) gibt den Parameterindex in einer nullbasierten Parameterliste an.
Hinweis
Dieser Wert kann nur auf 0 (null) festgelegt werden, da es in jeder Zelle nur einen Wert gibt.
Das Zeichen nach dem Doppelpunkt (im Beispiel B) gibt das Format an, in dem der Wert angezeigt wird. In der folgenden Tabelle sind die gebräuchlichen Formate aufgeführt.
Formatzeichen |
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 Standardformat an. |
N |
Zeigt numerische Werte im Zahlenformat an. |
X |
Zeigt numerische Werte im hexadezimalen Format an. |
Hinweis
Mit Ausnahme von X, bei dem die hexadezimalen Zeichen in der vorliegenden Schreibweise angezeigt werden, wird die Groß- und Kleinschreibung bei den Formatierungszeichen nicht berücksichtigt.
Der Wert nach dem Formatierungszeichen (in dem allgemeinen Beispiel xx) gibt die Anzahl der signifikanten Ziffern oder Dezimalstellen an, die angezeigt werden sollen.
Die folgende Tabelle enthält Beispiele von Formatierungszeichenfolgen und Ergebnissen. Dabei werden die Standardeinstellungen für Englisch vorausgesetzt.
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 |
"Gesamtsumme: {0:C}" |
Gesamtsumme: $12345.68 |
Weitere Informationen über Formatzeichenfolgen finden Sie unter Übersicht über Formatierung.
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 Übersicht über ASP.NET-Designs und ASP.NET-Skins.
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
ListControl-Klasse
ListControl-Member
System.Web.UI.WebControls-Namespace