ListControl.DataTextFormatString Свойство

Определение

Получает или задает строку форматирования, которая используется для управления отображением данных, связанных с элементом управления "Список".Gets or sets the formatting string used to control how data bound to the list control is displayed.

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; }
member this.DataTextFormatString : string with get, set
Public Overridable Property DataTextFormatString As String

Значение свойства

Строка форматирования данных, связанных с элементом управления "Список".The formatting string for data bound to the control. Значение по умолчанию — Empty.The default value is Empty.

Атрибуты

Комментарии

DataTextFormatString Используйте свойство, чтобы предоставить настраиваемый формат вывода элементов в элементе управления "список".Use the DataTextFormatString property to provide a custom display format the items in a list control.

Строка формата данных состоит из двух частей, разделенных двоеточием, в форме { A : Bxx }.The data format string consists of two parts, separated by a colon, in the form { A : Bxx }. Например, строка {0:F2} форматирования будет форматировать ячейку для вывода числа с фиксированной точкой с двумя десятичными разрядами.For example, the formatting string {0:F2} would format the cell to display a fixed point number with two decimal places.

Примечание

Вся строка должна быть заключена в фигурные скобки, чтобы указать, что это строка формата, а не литеральная строка.The entire string must be enclosed in braces to indicate that it is a format string and not a literal string. Любой текст за пределами фигурных скобок отображается как литеральный текст.Any text outside the braces is displayed as literal text.

Значение перед двоеточием (A в общем примере) указывает индекс параметра в списке параметров с отсчетом от нуля.The value before the colon (A in the general example) specifies the parameter index in a zero-based list of parameters.

Примечание

Этому значению можно присвоить только значение 0, поскольку в каждой ячейке содержится только одно значение.This value can only be set to 0 because there is only one value in each cell.

Символ после двоеточия (B в общем примере) задает формат для вывода значения в.The character after the colon (B in the general example) specifies the format to display the value in. В следующей таблице перечислены общие форматы.The following table lists the common formats.

Символ форматаFormat character ОписаниеDescription
C Отображает числовые значения в формате валюты.Displays numeric values in currency format.
D Отображает числовые значения в десятичном формате.Displays numeric values in decimal format.
E Отображает числовые значения в экспоненциальном (экспоненциальном) формате.Displays numeric values in scientific (exponential) format.
F Отображает числовые значения в фиксированном формате.Displays numeric values in fixed format.
G Отображает числовые значения в общем формате.Displays numeric values in general format.
N Отображает числовые значения в числовом формате.Displays numeric values in number format.
X Отображает числовые значения в шестнадцатеричном формате.Displays numeric values in hexadecimal format.

Примечание

Регистр символов формата не учитывается, за исключением X, который отображает шестнадцатеричные символы в указанном варианте.The format character is not case-sensitive, except for X, which displays the hexadecimal characters in the case specified.

Значение после символа формата (xx в общем примере) указывает количество значащих цифр или десятичных разрядов для вывода.The value after the format character (xx in the general example) specifies the number of significant digits or decimal places to display.

В следующей таблице содержатся примеры строк форматирования и результаты.The following table contains examples of formatting strings and the results. В нем предполагается Стандартная настройка на английском языке.It assumes standard English settings.

Числовое значениеNumeric Value Строка форматаFormat String РезультатResult
12345.678912345.6789 "{0:C}""{0:C}" $12,345.68$12,345.68
-12345.6789-12345.6789 "{0:C}""{0:C}" ($12,345.68)($12,345.68)
1234512345 "{0:D}""{0:D}" 1234512345
1234512345 "{0:D8}""{0:D8}" 0001234500012345
12345.678912345.6789 "{0:E}""{0:E}" 1234568E+0041234568E+004
12345.678912345.6789 "{0:E10}""{0:E10}" 1.2345678900 E + 0041.2345678900E+004
12345.678912345.6789 "{0:F}""{0:F}" 12345.6812345.68
12345.678912345.6789 "{0:F0}""{0:F0}" 1234612346
12345.678912345.6789 "{0:G}""{0:G}" 12345.678912345.6789
123456789123456789 "{0:G7}""{0:G7}" 1.234568 E81.234568E8
12345.678912345.6789 "{0:N}""{0:N}" 12,345.6812,345.68
123456789123456789 "{0:N4}""{0:N4}" 123,456,789.0000123,456,789.0000
12345.678912345.6789 "Всего: {0:C}""Total: {0:C}" Всего: $12345,68Total: $12345.68

Дополнительные сведения о форматировании строк см. в статье Общие сведения о форматировании.For more information on formatting strings, see Formatting Types.

Значение этого свойства хранится в состоянии представления.The value of this property is stored in view state.

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей.This property cannot be set by themes or style sheet themes. Дополнительные сведения см ThemeableAttribute . в статьях и ASP.NET Themes и обложки.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Применяется к

Дополнительно