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, setPublic 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 | "Итог: {0:C}" | Всего: \$12345.68 |
Дополнительные сведения о форматировании строк см. в разделе "Типы форматирования".
Значение этого свойства хранится в состоянии представления.
Это свойство не может быть задано темами или темами таблицы стилей. Дополнительные сведения см. в статье ThemeableAttributeи ASP.NET темы и скины.
