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属性值
一个格式字符串，指定字段值的显示格式。 默认值为空字符串（“），指示不对字段值应用特殊格式。
注解
使用 DataFormatString 属性为对象中显示的 BoundField 值指定自定义显示格式。 如果未设置该 DataFormatString 属性，则显示字段的值没有任何特殊格式。
注释
在低于 3.5 的 ASP.NET 版本中，必须将属性false设置为HtmlEncode格式化不是字符串数据类型的字段。 否则，字段值在应用属性中 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 |
以十进制格式显示整数值。 可以指定位数。 （虽然类型称为“十进制”，但数字的格式为整数。 | 格式：{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或DoubleBigInteger值。 |
格式：{0:R}123456789.12345678 -> 123456789.12345678 |
X 或 x |
以十六进制格式显示整数值。 可以指定位数。 | 格式：{0:X}255 -> FF 格式： {0:x4}255 -> 00ff |
有关详细信息和显示其他区域性值格式的示例，请参阅 标准数字格式字符串。 还可以创建自定义数字格式字符串。 有关详细信息，请参阅 自定义数字格式字符串。
下表列出了字段的格式字符 DateTime 。 这些格式规范中的大多数都会导致不同的输出，具体取决于区域性设置。 这些示例的 DateTime 值为 2009/6/15 下午 1：45：30，区域性设置为 en-US。
| 设置字符格式 | 说明 | 示例 |
|---|---|---|
d |
短日期模式。 | 格式：{0:d}2009/6/15 下午 1：45：30 -> 2009/6/15 |
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 -> 2009/6/15 下午 1：45：30 |
M 或 m |
月/日模式。 | 格式：{0:M}2009/6/15 下午 1：45：30 -> 6 月 15 日 |
O 或 o |
往返日期/时间模式。 | 格式：{0:o}2009/6/15 下午 1：45：30 -> 2009-06-15T13：45：30.0900000 |
R 或 r |
RFC1123模式（有关信息，请参阅 DateTimeFormatInfo.RFC1123Pattern）。 | 格式：{0:R}2009/6/15 下午 1：45：30 -> 2009 年 6 月 15 日 20：45：30 GMT |
s |
可排序日期/时间模式。 | 格式：{0:s}2009/6/15 下午 1：45：30 -> 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}2009/6/15 下午 1：45：30 -> 2009-06-15 20：45：30Z |
U |
通用完整日期/时间模式。 | 格式：{0:U}2009/6/15 下午 1：45：30 -> 2009 年 6 月 15 日星期一 8：45：30 PM |
Y 或 y |
年月模式。 | 格式：{0:Y}2009/6/15 下午 1：45：30 -> 2009 年 6 月 |
有关详细信息和显示其他区域性值格式的示例，请参阅 标准日期和时间格式字符串。 还可以创建自定义日期和时间格式字符串。 有关详细信息，请参阅 自定义日期和时间格式字符串。
