共用方式為


BoundField.DataFormatString 屬性

定義

取得或設定字串,指定欄位值的顯示格式。

public:
 virtual property System::String ^ DataFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataFormatString { get; set; }
member this.DataFormatString : string with get, set
Public Overridable Property DataFormatString As String

屬性值

指定欄位值顯示格式的格式化字串。 預設為空字串 (""),表示未將特殊格式套用至該欄位值。

範例

具有原始程式碼的 Visual Studio 網站專案隨附于本主題: 下載

下列範例示範如何使用 DataFormatString 屬性來指定欄位值的自訂顯示格式。

下列範例顯示此範例所產生之輸出的一個資料列。

ProductID 名稱 ProductNumber ListPrice Weight ModifiedDate
000680 HL Road Frame - Black, 58 #FR-R92B-58 $1,431.50 1016.040 3/11/2004

備註

DataFormatString使用 屬性可指定 物件中所 BoundField 顯示值的自訂顯示格式。 DataFormatString如果未設定屬性,則會顯示欄位的值,而不需任何特殊格式設定。

注意

在 3.5 之前的 ASP.NET 版本中,您必須將 HtmlEncode 屬性設定為 false ,才能格式化不是字串資料類型的欄位。 否則,域值會先依預設轉換方法轉換成字串,然後再套用儲存在 屬性中的 DataFormatString 格式字串。

根據預設,只有當包含 BoundField 物件的資料繫結控制項處於唯讀模式時,才會將格式化字串套用至域值。 若要在編輯模式中將格式化字串套用至域值,請將 ApplyFormatInEditMode 屬性設定為 true

格式化字串可以是任何常值字串,通常包含欄位值的預留位置。 例如,在格式化字串 Item Value: {0} 中,當字串顯示在 物件中 BoundField 時,欄位的值會取代 {0} 預留位置。 格式化字串的其餘部分會顯示為常值文字。

如果格式化字串不包含預留位置,則只會在最終顯示文字中包含格式化字串本身, (資料來源中的域值不包含) 。 如果預留位置是 0 (零) 以大括弧括住,如上述範例所示,則域值會依預設方法轉換成字串。 您可以將字串附加至零,指定域值的格式。 例如,數值欄位的預留位置 {0:C} 會指定欄位的值應該轉換成貨幣格式。

格式設定是使用 Format 方法套用。 在左大括弧後面的數位是該方法所使用的語法的一部分,並指出預留位置應該使用的一系列值之一。 因為每個儲存格中只有一個域值,所以左大括弧後面的數位只能設定為 0。

下表列出數值欄位的標準格式字元。 這些格式字元不區分大小寫,但 除外 X ,它會在指定的大小寫中顯示十六進位字元。 您可以將數位附加至大部分格式字元,以指定您想要顯示的有效位數或小數位數。

注意

在大部分情況下,格式取決於伺服器的文化特性設定。 這些範例適用于 的文化 en-US 特性設定。

格式化字元 說明 範例
Cc 以貨幣格式顯示數值。 您可以指定小數位數。 格式: {0:C}

123.456 - > $123.46

格式: {0:C3}

123.456 - > $123.456
Dd 以十進位格式顯示整數值。 您可以指定位數。 (雖然類型稱為「decimal」,但數位會格式化為 integers.) 格式: {0:D}

1234 - > 1234

格式: {0:D6}

1234 - > 001234
Ee 以科學 (指數) 格式顯示數值。 您可以指定小數位數。 格式: {0:E}

1052.0329112756 - > 1.052033E+003

格式: {0:E2}

-1052.0329112756 - > -1.05e+003
Ff 以固定格式顯示數值。 您可以指定小數位數。 格式: {0:F}

1234.567 - > 1234.57

格式: {0:F3}

1234.567 - > 1234.567
Gg 以一般格式顯示數值, (最精簡的固定點或科學標記法) 。 您可以指定有效位數。 格式: {0:G}

-123.456 - > -123.456

格式: {0:G2}

-123.456 - > -120
Nn 以數位格式顯示數值, (包括群組分隔符號和選擇性負號) 。 您可以指定小數位數。 格式: {0:N}

1234.567 - > 1,234.57

格式: {0:N4}

1234.567 - > 1,234.5670
Pp 以百分比格式顯示數值。 您可以指定小數位數。 格式: {0:P}

1 - > 100.00%

格式: {0:P1}

.5 - > 50.0%
Rr 以來回格式顯示 SingleDoubleBigInteger 值。 格式: {0:R}

123456789.12345678 - > 123456789.12345678
Xx 以十六進位格式顯示整數值。 您可以指定位數。 格式: {0:X}

255 - > FF

格式: {0:x4}

255 - > 00ff

如需詳細資訊,以及顯示其他文化特性值格式設定的範例,請參閱 標準數值格式字串。 您也可以建立自訂數值格式字串。 如需詳細資訊,請參閱自訂數值格式字串

下表列出欄位的格式字元 DateTime 。 大部分的格式設定規格都會根據文化特性設定而產生不同的輸出。 這些範例適用于 DateTime 2009/6/15/1:45:30 PM 的值,其文化特性設定為 en-US

格式化字元 說明 範例
d 簡短日期模式。 格式: {0:d}

6/15/2009 下午 1:45:30 - > 6/15/2009
D 完整日期模式。 格式: {0:D}

6/15/2009 下午 1:45:30 - > 星期一,2009 年 6 月 15 日
f 完整日期/時間模式 (簡短時間)。 格式: {0:f}

6/15/2009 下午 1:45:30 - > 星期一,2009 年 6 月 15 日下午 1:45
F 完整日期/時間模式 (完整時間)。 格式: {0:F}

6/15/2009 下午 1:45:30 - > 星期一,2009 年 6 月 15 日下午 1:45:30
g 一般日期/時間模式 (簡短時間)。 格式: {0:g}

6/15/2009 下午 1:45:30 - > 6/15/2009 下午 1:45
G 一般日期/時間模式 (完整時間)。 格式: {0:G}

6/15/2009 下午 1:45:30 - > 6/15/2009 下午 1:45:30
Mm 月/日模式。 格式: {0:M}

2009/6/15 下午 1:45:30 - > 6 月 15 日
Oo 來回日期/時間模式。 格式: {0:o}

6/15/2009 下午 1:45:30 - > 2009-06-15T13:45:30.0900000
Rr RFC1123 模式 (,如需詳細資訊,請參閱 DateTimeFormatInfo.RFC1123Pattern) 。 格式: {0:R}

6/15/2009 下午 1:45:30 - > Mon, 15 Jun 2009 20:45:30 GMT
s 可排序日期/時間模式。 格式: {0:s}

6/15/2009 下午 1:45:30 - > 2009-06-15T13:45:30
t 簡短時間模式。 格式: {0:t}

6/15/2009 下午 1:45:30 - > 下午 1:45
T 完整時間模式。 格式: {0:T}

6/15/2009 下午 1:45:30 - > 下午 1:45:30
u 國際可排序日期/時間模式。 格式: {0:u}

6/15/2009 下午 1:45:30 - > 2009-06-15 20:45:30Z
U 國際完整日期/時間模式。 格式: {0:U}

6/15/2009 下午 1:45:30 - > 星期一,2009 年 6 月 15 日下午 8:45:30
Yy 年月模式。 格式: {0:Y}

6/15/2009 下午 1:45:30 - > 2009 年 6 月

如需詳細資訊,以及顯示其他文化特性值格式設定的範例,請參閱 標準日期和時間格式字串。 您也可以建立自訂日期和時間格式字串。 如需詳細資訊,請參閱 自訂日期和時間格式字串

適用於

另請參閱