BoundField.DataFormatString Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Получает или задает строку, определяющую формат отображения значения поля.

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, set
Public Overridable Property DataFormatString As String

Значение свойства

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

Дополнительные сведения и примеры форматирования для других значений языка и региональных параметров см. в разделе Стандартные строки формата даты и времени. Вы также можете создавать настраиваемые строки формата даты и времени. Дополнительные сведения см. в разделе Настраиваемые строки формата даты и времени.

Применяется к

См. также раздел