BoundField.DataFormatString Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает строку, указывающую формат отображения для значения поля.
public:
virtual property System::String ^ DataFormatString { System::String ^ get(); void set(System::String ^ value); };public virtual string DataFormatString { get; set; }member this.DataFormatString : string with get, setPublic Overridable Property DataFormatString As StringЗначение свойства
Строка форматирования, указывающая формат отображения значения поля. Значение по умолчанию — пустая строка (""), указывающая, что к значению поля не применяется специальное форматирование.
Комментарии
DataFormatString Используйте свойство, чтобы указать пользовательский формат отображения для значений, отображаемых в объектеBoundField. DataFormatString Если свойство не задано, значение поля отображается без специального форматирования.
Замечание
В версиях ASP.NET выше 3.5 необходимо задать HtmlEncode свойство false для форматирования полей, которые не являются строковыми типами данных. В противном случае значение поля преобразуется в строку методом преобразования по умолчанию перед применением строки форматирования, хранящейся в свойстве DataFormatString .
По умолчанию строка форматирования применяется к значению поля только в том случае, если элемент управления с привязкой к данным, содержащий BoundField объект, находится в режиме только для чтения. Чтобы применить строку форматирования к значениям полей в режиме редактирования, задайте ApplyFormatInEditMode для свойства значение true.
Строка форматирования может быть любой литеральной строкой и обычно включает заполнитель для значения поля. Например, в строке Item Value: {0}форматирования значение поля заменяет {0} заполнитель при отображении строки в объекте BoundField . Остальная часть строки форматирования отображается в виде литерального текста.
Если строка форматирования не включает заполнитель, в окончательный текст отображается только строка форматирования (значение поля из источника данных не включается). Если заполнитель равен 0 (ноль), заключенный в фигурные скобки, как показано в предыдущем примере, значение поля преобразуется в строку по умолчанию. Можно добавить к нулю строку, указывающую, как должно быть отформатировано значение поля. Например, заполнитель {0:C} для числового поля указывает, что значение поля должно быть преобразовано в формат валюты.
Форматирование применяется с помощью Format метода. Число, следующее за левой фигурной скобкой, является частью синтаксиса, используемого этим методом, и указывает, какой из ряда значений должен использовать заполнитель. Так как в каждой ячейке имеется только одно значение поля, число, следующее за левой фигурной скобкой, может быть задано только 0.
В следующей таблице перечислены стандартные символы формата для числовых полей. Эти символы формата не учитывает регистр, за исключением Xтого, что в указанном случае отображаются шестнадцатеричные символы. Можно добавить число к большинству символов форматирования, чтобы указать, сколько значимых цифр или десятичных разрядов вы хотите отобразить.
Замечание
В большинстве случаев форматирование зависит от параметра языка и региональных параметров сервера. Примеры приведены для параметра языка и региональных параметров en-US.
| Формат символа | Описание | Пример |
|---|---|---|
C или c |
Отображает числовые значения в формате валюты. Можно указать число десятичных разрядов. | Формат: {0:C}123.456 -> \$123.46 Формат: {0:C3}123.456 -> \$123.456 |
D или d |
Отображает целые значения в десятичном формате. Можно указать число цифр. (Хотя тип называется десятичным, числа форматируются как целые числа.) | Формат: {0:D}1234 -> 1234 Формат: {0:D6}1234 -> 001234 |
E или e |
Отображает числовые значения в формате экспоненциального формата. Можно указать число десятичных разрядов. | Формат: {0:E}1052.0329112756 -> 1.052033E+003 Формат: {0:E2}-1052.0329112756 -> -1.05e+003 |
F или f |
Отображает числовые значения в фиксированном формате. Можно указать число десятичных разрядов. | Формат: {0:F}1234.567 -> 1234.57 Формат: {0:F3}1234.567 -> 1234.567 |
G или g |
Отображает числовые значения в общем формате (самый компактный из фиксированной точки или научной нотации). Можно указать количество значимых цифр. | Формат: {0:G}-123.456 -> -123.456 Формат: {0:G2}-123.456 -> -120 |
N или n |
Отображает числовые значения в формате чисел (включая разделители групп и необязательный отрицательный знак). Можно указать число десятичных разрядов. | Формат: {0:N}1234.567 -> 1,234.57 Формат: {0:N4}1234.567 -> 1,234.5670 |
P или p |
Отображает числовые значения в формате процента. Можно указать число десятичных разрядов. | Формат: {0:P}1 –> 100.00% Формат: {0:P1}.5 –> 50.0% |
R или r |
Отображает Singleзначения или DoubleBigInteger значения в формате кругового пути. |
Формат: {0:R}123456789.12345678 -> 123456789.12345678 |
X или x |
Отображает целые значения в шестнадцатеричном формате. Можно указать число цифр. | Формат: {0:X}255 -> FF Формат: {0:x4}255 –> 00ff |
Дополнительные сведения и примеры форматирования для других значений языка и региональных параметров см. в разделе "Стандартные числовые строки формата". Вы также можете создавать пользовательские строки числовых форматов. Дополнительные сведения см. в разделе "Строки настраиваемого числового формата".
В следующей таблице перечислены символы форматирования полей DateTime . Большинство этих спецификаций форматирования приводят к разным выходным данным в зависимости от параметров языка и региональных параметров. Примеры приведены для DateTime значения 6.15.2009 1:45:30 с параметром языка и региональных параметров en-US.
| Формат символа | Описание | Пример |
|---|---|---|
d |
Короткий шаблон даты. | Формат: {0:d}6.15.2009 1:45:30 –> 6.15.2009 |
D |
Полный шаблон даты. | Формат: {0:D}6.15.2009 1:45:30 ->Понедельник, 15 июня 2009 г. |
f |
Полный шаблон даты и времени (короткий шаблон времени). | Формат: {0:f}6.15.2009 1:45:30 –> понедельник, 15 июня 2009 г. 1:45 вечера |
F |
Полный шаблон даты и времени (полный шаблон времени). | Формат: {0:F}6.15.2009 1:45:30 –> понедельник, 15 июня 2009 г. 1:45:30 |
g |
Общий шаблон даты и времени (короткий шаблон времени). | Формат: {0:g}6.15.2009 1:45:30 –> 6.15.2009 1:45 |
G |
Общий шаблон даты и времени (полный шаблон времени). | Формат: {0:G}6.15.2009 1:45:30 –> 6.15.2009 1:45:30 |
M или m |
Шаблон дней месяца. | Формат: {0:M}6.15.2009 1:45:30 –> 15 июня |
O или o |
Шаблон даты и времени круглого пути. | Формат: {0:o}6.15.2009 1:45:30 -> 2009-06-15T13:45:30.0900000 |
R или r |
RFC1123 шаблон (сведения см. в разделе DateTimeFormatInfo.RFC1123Pattern). | Формат: {0:R}6.15.2009 1:45:30> - Mon, 15 июня 2009 20:45:30 GMT |
s |
Сортируемый шаблон времени и даты. | Формат: {0:s}6.15.2009 1:45:30 -> 2009-06-15T13:45:30 |
t |
Короткий шаблон времени. | Формат: {0:t}6.15.2009 1:45:30 –> 1:45 |
T |
Полный шаблон времени. | Формат: {0:T}6.15.2009 1:45:30 –> 1:45:30 |
u |
Универсальный сортируемый шаблон времени и даты. | Формат: {0:u}6.15.2009 1:45:30 –> 2009-06-15 20:45:30Z |
U |
Универсальный шаблон даты и времени. | Формат: {0:U}6.15.2009 1:45:30 –> понедельник, 15 июня 2009 г. 8:45:30 вечера |
Y или y |
Шаблон месяца года. | Формат: {0:Y}6.15.2009 1:45:30 –> июнь 2009 г. |
Дополнительные сведения и примеры форматирования для других значений языка и региональных параметров см. в разделе "Стандартные строки формата даты и времени". Вы также можете создавать настраиваемые строки формата даты и времени. Дополнительные сведения см. в разделе "Строки настраиваемого формата даты и времени".
