ListControl.DataTextFormatString 屬性

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.dll

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

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; }

[<System.Web.UI.Themeable(false)>]
member this.DataTextFormatString : string with get, set

Public Overridable Property DataTextFormatString As String

屬性值

String

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

屬性

ThemeableAttribute

備註

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

資料格式字串是由兩個部分所組成，並以冒號分隔，格式為 { A ： Bxx }。 例如，格式化字串 {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

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

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

這個屬性無法由佈景主題或樣式表主題設定。 如需詳細資訊，請參閱 ThemeableAttribute 和 ASP.NET 主題和外觀。

另請參閱

• 在 .NET 中將類型格式化