共用方式為


ListControl.DataTextFormatString 屬性

定義

取得或設定格式化字串,這個字串可用來控制繫結至清單控制項之資料的顯示方式。

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

屬性值

繫結至控制項之資料的格式化字串。 預設值是 Empty

屬性

備註

DataTextFormatString使用屬性提供自定義顯示格式的清單控制項中的專案。

數據格式字串是由兩個部分所組成,並以冒號分隔,格式為 { ABxx }。 例如,格式化字串 {0:F2} 會將儲存格格式化,以顯示具有兩個小數位數的固定點數。

注意

整個字串必須以大括弧括住,以指出它是格式字串,而不是常值字串。 大括弧以外的任何文字都會顯示為常值文字。

一般範例中的冒號 (A 之前的值,) 在以零起始的參數清單中指定參數索引。

注意

此值只能設定為 0,因為每個儲存格中只有一個值。

一般範例中冒號之後的字元 (B ,) 指定要顯示值的格式。 下表列出常見的格式。

格式化字元 說明
C 以貨幣格式顯示數值。
D 以十進位格式顯示數值。
E 以科學 (指數) 格式顯示數值。
F 以固定格式顯示數值。
G 以一般格式顯示數值。
N 以數位格式顯示數值。
X 以十六進位格式顯示數值。

注意

格式字元不區分大小寫,但 除外 X,這會在指定的大小寫中顯示十六進位字元。

在一般範例 (xx 格式字元之後的值,) 會指定要顯示的有效位數或小數字數。

下表包含格式化字串和結果的範例。 它會假設標準英文設定。

數值 格式字串 結果
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 “Total: {0:C}” 總計: $12345.68

如需格式化字串的詳細資訊,請參閱格式化類型

此屬性的值會儲存在檢視狀態中。

這個屬性無法由佈景主題或樣式表主題設定。 如需詳細資訊,請參閱 ThemeableAttributeASP.NET 主題和面板

適用於

另請參閱