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, set
Public 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 主题和外观。
适用于
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈