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 主题和皮肤。
