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 предоставления пользовательского формата отображения элементов в элементе управления "Список".

Строка формата данных состоит из двух частей, разделенных двоеточием, в форме { 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 "Всего: {0:C}" Итого: $12345.68

Дополнительные сведения о форматировании строк см. в статье Общие сведения о форматировании.

Значение этого свойства хранится в состоянии представления.

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей. Дополнительные сведения см. в разделах ThemeableAttribute и ASP.NET Темы и обложки.

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

См. также раздел