ListControl.DataTextFormatString 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定格式化字串，這個字串可用來控制繫結至清單控制項之資料的顯示方式。
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, setPublic Overridable Property DataTextFormatString As String屬性值
繫結至控制項之資料的格式化字串。 預設值是 Empty。
- 屬性
備註
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 主題和面板。
