ListControl.DataTextFormatString 属性

定义

获取或设置格式化字符串,该字符串用来控制如何显示绑定到列表控件的数据。

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使用 属性为列表控件中的项提供自定义显示格式。

数据格式字符串由两部分组成,由冒号分隔,格式为 { ABxx }。 例如,格式字符串 {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

有关设置字符串格式的详细信息,请参阅格式设置类型

此属性的值存储在视图状态中。

无法通过主题或样式表主题设置此属性。 有关详细信息,请参阅 ThemeableAttributeASP.NET 主题和皮肤

适用于

另请参阅