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 темы и обложки.
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по