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