ListControl.DataTextFormatString 属性

定义

命名空间:

System.Web.UI.WebControls

程序集:

System.Web.dll

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

public:
 virtual property System::String ^ DataTextFormatString { System::String ^ get(); void set(System::String ^ value); };

[System.Web.UI.Themeable(false)]
public virtual string DataTextFormatString { get; set; }

[<System.Web.UI.Themeable(false)>]
member this.DataTextFormatString : string with get, set

Public Overridable Property DataTextFormatString As String

属性值

String

绑定到控件的数据的格式化字符串。 默认值是 Empty。

属性

ThemeableAttribute

注解

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 主题和外观。

另请参阅

• 设置 .NET 中类型的格式