BoundField.DataFormatString 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

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

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

屬性值

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 特性設定。

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

123.456 - > $123.46

格式： {0:C3}

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

1234 - > 1234

格式： {0:D6}

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

1052.0329112756 - > 1.052033E+003

格式： {0:E2}

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

1234.567 - > 1234.57

格式： {0:F3}

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

-123.456 - > -123.456

格式： {0:G2}

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

1234.567 - > 1，234.57

格式： {0:N4}

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

1 - > 100.00%

格式： {0:P1}

.5 - > 50.0%
R 或 r 以來回格式顯示 Single 、 Double 或 BigInteger 值。 格式： {0:R}

123456789.12345678 - > 123456789.12345678
X 或 x 以十六進位格式顯示整數值。 您可以指定位數。 格式： {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
M 或 m 月/日模式。 格式： {0:M}

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

6/15/2009 下午 1：45：30 - > 2009-06-15T13：45：30.0900000
R 或 r 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
Y 或 y 年月模式。 格式： {0:Y}

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

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

適用於

另請參閱