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Значение свойства
Строка форматирования, определяющая формат отображения значения поля. По умолчанию это пустая строка (""), указывающая на неприменение к значению поля специального форматирования.
Примеры
Проект веб-сайта Visual Studio с исходным кодом доступен в следующем разделе: Скачивание.
В следующем примере показано, как использовать DataFormatString свойство для указания настраиваемого формата отображения для значений поля.
В следующем примере показана одна строка выходных данных, созданных в этом примере.
| ProductID | Имя | ProductNumber | ListPrice | Вес | ModifiedDate |
|---|---|---|---|---|---|
000680 |
HL Road Frame - Black, 58 |
#FR-R92B-58 |
$1,431.50 |
1016.040 |
3/11/2004 |
Комментарии
Используйте свойство , DataFormatString чтобы указать пользовательский формат отображения значений, отображаемых в объекте BoundField . DataFormatString Если свойство не задано, значение поля отображается без специального форматирования.
Примечание
В версиях ASP.NET более ранних, чем 3.5, необходимо присвоить свойству HtmlEncodefalse значение , чтобы форматировать поля, которые не являются строковыми типами данных. В противном случае значение поля преобразуется в строку методом преобразования по умолчанию перед применением строки формата, хранящейся в свойстве 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 |
Отображает целочисленные значения в десятичном формате. Можно указать количество цифр. (Хотя тип называется "decimal", числа форматируются как целые числа.) | Формат: {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}0,5–> 50,0 % |
R либо r |
Отображает Singleзначения , Doubleили BigInteger в формате кругового пути. |
Формат: {0:R}123456789.12345678 —> 123456789.12345678 |
X либо x |
Отображает целочисленные значения в шестнадцатеричном формате. Можно указать количество цифр. | Формат: {0:X}255 -> FF Формат: {0:x4}255 -> 00ff |
Дополнительные сведения и примеры форматирования для других значений языка и региональных параметров см. в разделе Строки стандартного числового формата. Можно также создавать настраиваемые строки числового формата. Дополнительные сведения см. в разделе Строки настраиваемых числовых форматов.
В следующей таблице перечислены символы формата для DateTime полей. Большинство из этих спецификаций форматирования приводят к разным выходным данным в зависимости от параметров языка и региональных параметров. Примеры приведены для DateTime значения 15.06.2009 13:45:30 с параметром языка и региональных en-USпараметров .
| Формат символа | Описание | Пример |
|---|---|---|
d |
Короткий шаблон даты. | Формат: {0:d}15.06.2009 13:45:30 -> 15.06.2009 |
D |
Полный шаблон даты. | Формат: {0:D}15.06.2009 13:45:30 ->15 июня 2009 г. |
f |
Полный шаблон даты и времени (короткий шаблон времени). | Формат: {0:f}15.06.2009 13:45:30 -> 15 июня 2009 г. 13:45 |
F |
Полный шаблон даты и времени (полный шаблон времени). | Формат: {0:F}15.06.2009 13:45:30 -> 15 июня 2009 г. 13:45:30 |
g |
Общий шаблон даты и времени (короткий шаблон времени). | Формат: {0:g}15.06.2009 13:45:30 -> 15.06.2009 13:45 |
G |
Общий шаблон даты и времени (полный шаблон времени). | Формат: {0:G}15.06.2009 13:45:30 -> 15.06.2009 13:45:30 |
M либо m |
Шаблон дней месяца. | Формат: {0:M}15.06.2009 13:45:30 -> 15 июня |
O либо o |
Шаблон обратного преобразования даты и времени. | Формат: {0:o}15.06.2009 1:45:30 PM -> 2009-06-15T13:45:30.09000000 |
R либо r |
Шаблон RFC1123 (дополнительные сведения см. в разделе DateTimeFormatInfo.RFC1123Pattern). | Формат: {0:R}15.06.2009 1:45:30 PM -> Пн, 15 Июня 2009 20:45:30 GMT |
s |
Сортируемый шаблон времени и даты. | Формат: {0:s}15.06.2009 1:45:30 -> 2009-06-15T13:45:30 |
t |
Короткий шаблон времени. | Формат: {0:t}15.06.2009 13:45:30 -> 13:45 |
T |
Полный шаблон времени. | Формат: {0:T}15.06.2009 13:45:30 –> 13:45:30 |
u |
Универсальный сортируемый шаблон времени и даты. | Формат: {0:u}15.06.2009 13:45:30 -> 2009-06-15 20:45:30Z |
U |
Универсальный полный шаблон даты и времени. | Формат: {0:U}15.06.2009 13:45:30 -> 15 июня 2009 г. 20:45:30 |
Y либо y |
Шаблон месяца года. | Формат: {0:Y}15.06.2009 13:45:30 -> Июнь, 2009 |
Дополнительные сведения и примеры форматирования для других значений языка и региональных параметров см. в разделе Стандартные строки формата даты и времени. Вы также можете создавать настраиваемые строки формата даты и времени. Дополнительные сведения см. в разделе Настраиваемые строки формата даты и времени.
