BoundField.DataFormatString 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置字符串，该字符串指定字段值的显示格式。
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, setPublic Overridable Property DataFormatString As String属性值
指定字段值的显示格式的格式化字符串。 默认值为空字符串 ("")，表示尚无特殊格式设置应用于该字段值。
示例
Visual Studio包含源代码的网站项目可随本主题一起提供：下载。
以下示例演示如何使用 DataFormatString 属性为字段的值指定自定义显示格式。
以下示例显示了此示例生成的输出的一行。
| ProductID | 名称 | ProductNumber | ListPrice | 重量 | ModifiedDate |
|---|---|---|---|---|---|
000680 |
HL Road Frame - Black, 58 |
#FR-R92B-58 |
$1,431.50 |
1016.040 |
3/11/2004 |
注解
使用 DataFormatString 属性为对象中显示的 BoundField 值指定自定义显示格式。 如果未设置该 DataFormatString 属性，则不带任何特殊格式显示字段的值。
备注
In versions of ASP.NET earlier than 3.5, you must set the HtmlEncode property to false in order to format fields that are not string data types. 否则，字段值将按默认转换方法转换为字符串，然后应用属性中 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}2009/6/15 下午 1：45：30 -> 6/15/2009 |
D |
长日期模式。 | 格式：{0:D}2009/6/15 下午 1：45：30 ->2009 年 6 月 15 日星期一 |
f |
完整日期/时间模式（短时间）。 | 格式：{0:f}2009/6/15 下午 1：45：30 -> 2009 年 6 月 15 日星期一下午 1：45 |
F |
完整日期/时间模式（长时间）。 | 格式：{0:F}2009/6/15 下午 1：45：30 -> 2009 年 6 月 15 日星期一下午 1：45：30 |
g |
常规日期/时间模式（短时间）。 | 格式：{0:g}2009/6/15 下午 1：45：30 -> 2009/6/15 下午 1：45 |
G |
常规日期/时间模式（长时间）。 | 格式：{0:G}2009/6/15 下午 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 PM -> 2009-06-15T13:45:30.0900000 |
R 或 r |
有关信息的信息，RFC1123 模式 (，请参阅 DateTimeFormatInfo.RFC1123Pattern) 。 | 格式：{0:R}6/15/2009 1:45:30 PM -> Mon, 15 Jun 2009 20:45:30 GMT |
s |
可排序日期/时间模式。 | 格式：{0:s}6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30 |
t |
短时间模式。 | 格式：{0:t}2009/6/15 下午 1：45：30 ->下午 1：45 |
T |
长时间模式。 | 格式：{0:T}2009/6/15 下午 1：45：30 ->下午 1：45：30 |
u |
通用可排序日期/时间模式。 | 格式：{0:u}6/15/2009 1:45:30 PM -> 2009-06-15 20:45:30Z |
U |
通用完整日期/时间模式。 | 格式：{0:U}2009/6/15 下午 1：45：30 -> 2009 年 6 月 15 日星期一下午 8：45：30 |
Y 或 y |
年月模式。 | 格式：{0:Y}2009/6/15 下午 1：45：30 -> 2009 年 6 月 |
有关详细信息以及显示其他区域性值格式的示例，请参阅 标准日期和时间格式字符串。 还可以创建自定义日期和时间格式字符串。 有关详细信息，请参阅 自定义日期和时间格式字符串。