BoundField.DataFormatString Свойство

Определение

Получает или задает строку, определяющую формат отображения значения поля.Gets or sets the string that specifies the display format for the value of the field.

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

Строка форматирования, определяющая формат отображения значения поля.A formatting string that specifies the display format for the value of the field. По умолчанию это пустая строка (""), указывающая на неприменение к значению поля специального форматирования.The default is an empty string (""), which indicates that no special formatting is applied to the field value.

Примеры

Проект веб-сайта Visual Studio с исходным кодом можно найти в этой статье: download.A Visual Studio Web site project with source code is available to accompany this topic: Download.

В следующем примере показано использование DataFormatString свойства для задания пользовательского формата отображения значений поля.The following example shows how to use the DataFormatString property to specify a custom display format for the values of a field.

В следующем примере показана одна строка выходных данных, которая создается в этом примере.The following example shows one row of the output that is produced by this example.

ProductIDProductID ИмяName ProductNumberProductNumber ListPriceListPrice ВесWeight ModifiedDateModifiedDate
000680 HL Road Frame - Black, 58 #FR-R92B-58 $1,431.50 1016.040 3/11/2004

Комментарии

Используйте DataFormatString свойство, чтобы указать пользовательский формат отображения для значений, отображаемых в BoundField объекте.Use the DataFormatString property to specify a custom display format for the values that are displayed in the BoundField object. Если DataFormatString свойство не задано, значение поля отображается без специального форматирования.If the DataFormatString property is not set, the field's value is displayed without any special formatting.

Примечание

В версиях ASP.NET, предшествующих 3,5, необходимо присвоить HtmlEncode свойству значение false , чтобы форматировать поля, которые не являются строковыми типами данных.In versions of ASP.NET earlier than 3.5, you must set the HtmlEncode property to false in order to format fields that are not string data types. В противном случае значение поля преобразуется в строку методом преобразования по умолчанию перед применением строки формата, хранящейся в DataFormatString свойстве.Otherwise, the field value is converted to a string by the default conversion method before the format string that is stored in the DataFormatString property is applied.

По умолчанию строка форматирования применяется к значению поля только в том случае, если элемент управления с привязкой к данным, содержащий BoundField объект, находится в режиме только для чтения.By default, the formatting string is applied to the field value only when the data-bound control that contains the BoundField object is in read-only mode. Чтобы применить строку форматирования к значениям полей в режиме редактирования, присвойте ApplyFormatInEditMode свойству значение true .To apply the formatting string to field values while in edit mode, set the ApplyFormatInEditMode property to true.

Строка форматирования может быть любой строкой литерала и обычно содержит заполнитель для значения поля.The formatting string can be any literal string and usually includes a placeholder for the field's value. Например, в строке форматирования Item Value: {0} значение поля заменяется {0} заполнителем, когда строка отображается в BoundField объекте.For example, in the formatting string Item Value: {0}, the field's value is substituted for the {0} placeholder when the string is displayed in the BoundField object. Остальная часть строки форматирования отображается как литеральный текст.The rest of the formatting string is displayed as literal text.

Если строка форматирования не содержит заполнитель, в окончательный отображаемый текст включается только сама строка форматирования (значение поля из источника данных не включается).If the formatting string does not include a placeholder, only the formatting string itself is included in the final display text (the field's value from the data source is not included). Если заполнитель равен 0 (нулю), заключенному в фигурные скобки, как показано в предыдущем примере, значение поля преобразуется в строку методом по умолчанию.If the placeholder is a 0 (zero) enclosed in curly braces as shown in the preceding example, the field value is converted to a string by the default method. Можно добавить к нулю строку, указывающую, как должно быть отформатировано значение поля.You can append to the zero a string that specifies how the field value should be formatted. Например, заполнитель {0:C} для числового поля указывает, что значение поля должно быть преобразовано в формат валюты.For example, the placeholder {0:C} for a numeric field specifies that value of the field should be converted to a currency format.

Форматирование применяется с помощью Format метода.Formatting is applied by using the Format method. Число, следующее за левой фигурной скобкой, является частью синтаксиса, используемого этим методом, и указывает, какой из ряда значений должен использоваться заполнителем.The number that follows the left curly brace is part of the syntax used by that method and indicates which one of a series of values the placeholder should use. Поскольку в каждой ячейке имеется только одно значение поля, число, следующее за левой фигурной скобкой, может быть установлено только равным 0.Because there is only one field value in each cell, the number that follows the left curly brace can only be set to 0.

В следующей таблице перечислены стандартные символы формата для числовых полей.The following table lists the standard format characters for numeric fields. В этих символах формата регистр не учитывается, за исключением X , который отображает шестнадцатеричные символы в указанном случае.These format characters are not case-sensitive, except for X, which displays hexadecimal characters in the case that is specified. Можно добавить число в большинство символов формата, чтобы указать, сколько значащих цифр или десятичных разрядов требуется отобразить.You can append a number to most format characters in order to specify how many significant digits or decimal places you want to display.

Примечание

В большинстве случаев форматирование зависит от языка и региональных параметров сервера.In most cases, formatting depends on the server's culture setting. Примеры предназначены для языка и региональных параметров en-US .The examples are for a culture setting of en-US.

Символ форматаFormat character ОписаниеDescription ПримерExample
C либо cC or c Отображает числовые значения в формате валюты.Displays numeric values in currency format. Можно указать число десятичных разрядов.You can specify the number of decimal places. Формат: {0:C}Format: {0:C}

123.456 -> $123.46123.456 -> $123.46

Формат: {0:C3}Format: {0:C3}

123.456 -> $123.456123.456 -> $123.456
D либо dD or d Отображает целочисленные значения в десятичном формате.Displays integer values in decimal format. Можно указать количество цифр.You can specify the number of digits. (Хотя тип называется "Decimal", числа форматируются как целые числа.)(Although the type is referred to as "decimal", the numbers are formatted as integers.) Формат: {0:D}Format: {0:D}

1234 -> 12341234 -> 1234

Формат: {0:D6}Format: {0:D6}

1234 -> 0012341234 -> 001234
E либо eE or e Отображает числовые значения в экспоненциальном (экспоненциальном) формате.Displays numeric values in scientific (exponential) format. Можно указать число десятичных разрядов.You can specify the number of decimal places. Формат: {0:E}Format: {0:E}

1052,0329112756-> 1.052033 E + 0031052.0329112756 -> 1.052033E+003

Формат: {0:E2}Format: {0:E2}

-1052,0329112756->-1,05 e + 003-1052.0329112756 -> -1.05e+003
F либо fF or f Отображает числовые значения в фиксированном формате.Displays numeric values in fixed format. Можно указать число десятичных разрядов.You can specify the number of decimal places. Формат: {0:F}Format: {0:F}

1234.567 -> 1234.571234.567 -> 1234.57

Формат: {0:F3}Format: {0:F3}

1234.567 -> 1234.5671234.567 -> 1234.567
G либо gG or g Отображает числовые значения в общем формате (самая компактная часть нотации с фиксированной или экспоненциальной запятой).Displays numeric values in general format (the most compact of either fixed-point or scientific notation). Можно указать количество значащих цифр.You can specify the number of significant digits. Формат: {0:G}Format: {0:G}

-123.456 -> -123.456-123.456 -> -123.456

Формат: {0:G2}Format: {0:G2}

-123.456 -> -120-123.456 -> -120
N либо nN or n Отображает числовые значения в числовом формате (включая разделители групп и необязательный знак отрицательного числа).Displays numeric values in number format (including group separators and optional negative sign). Можно указать число десятичных разрядов.You can specify the number of decimal places. Формат: {0:N}Format: {0:N}

1234.567 -> 1,234.571234.567 -> 1,234.57

Формат: {0:N4}Format: {0:N4}

1234.567 -> 1,234.56701234.567 -> 1,234.5670
P либо pP or p Отображает числовые значения в процентном формате.Displays numeric values in percent format. Можно указать число десятичных разрядов.You can specify the number of decimal places. Формат: {0:P}Format: {0:P}

1 -> 100.00%1 -> 100.00%

Формат: {0:P1}Format: {0:P1}

.5 -> 50.0%.5 -> 50.0%
R либо rR or r Отображает Single Double значения, или BigInteger в формате приема-передачи.Displays Single, Double, or BigInteger values in round-trip format. Формат: {0:R}Format: {0:R}

123456789.12345678 -> 123456789.12345678123456789.12345678 -> 123456789.12345678
X либо xX or x Отображает целочисленные значения в шестнадцатеричном формате.Displays integer values in hexadecimal format. Можно указать количество цифр.You can specify the number of digits. Формат: {0:X}Format: {0:X}

255-> FF255 -> FF

Формат: {0:x4}Format: {0:x4}

255-> 00ff255 -> 00ff

Дополнительные сведения и примеры, демонстрирующие форматирование других значений языка и региональных параметров, см. в разделе строки стандартных числовых форматов.For more information and for examples that show formatting for other culture values, see Standard Numeric Format Strings. Можно также создавать строки настраиваемых числовых форматов.You can also create custom numeric format strings. Дополнительные сведения см. в разделе Строки настраиваемых числовых форматов.For more information, see Custom Numeric Format Strings.

В следующей таблице перечислены символы форматирования для DateTime полей.The following table lists format characters for DateTime fields. Большинство этих спецификаций форматирования приводят к различным результатам, в зависимости от настроек языка и региональных параметров.Most of these formatting specifications result in a different output depending on culture settings. В примерах используется DateTime значение 6/15/2009 1:45:30 PM с параметром culture en-US .The examples are for a DateTime value of 6/15/2009 1:45:30 PM with a culture setting of en-US.

Символ форматаFormat character ОписаниеDescription ПримерExample
d Короткий шаблон даты.Short date pattern. Формат: {0:d}Format: {0:d}

6/15/2009 1:45:30 PM-> 6/15/20096/15/2009 1:45:30 PM -> 6/15/2009
D Полный шаблон даты.Long date pattern. Формат: {0:D}Format: {0:D}

6/15/2009 1:45:30 PM->понедельник, 15 июня 2009 г.6/15/2009 1:45:30 PM ->Monday, June 15, 2009
f Полный шаблон даты и времени (короткий шаблон времени).Full date/time pattern (short time). Формат: {0:f}Format: {0:f}

6/15/2009 1:45:30 PM-> понедельник, 15 июня 2009 1:456/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45 PM
F Полный шаблон даты и времени (полный шаблон времени).Full date/time pattern (long time). Формат: {0:F}Format: {0:F}

6/15/2009 1:45:30 PM-> понедельник, 15 июня 2009 1:45:306/15/2009 1:45:30 PM -> Monday, June 15, 2009 1:45:30 PM
g Общий шаблон даты и времени (короткий шаблон времени).General date/time pattern (short time). Формат: {0:g}Format: {0:g}

6/15/2009 1:45:30 PM-> 6/15/2009 1:45 PM6/15/2009 1:45:30 PM -> 6/15/2009 1:45 PM
G Общий шаблон даты и времени (полный шаблон времени).General date/time pattern (long time). Формат: {0:G}Format: {0:G}

6/15/2009 1:45:30 PM-> 6/15/2009 1:45:30 PM6/15/2009 1:45:30 PM -> 6/15/2009 1:45:30 PM
M либо mM or m Шаблон дней месяца.Month/day pattern. Формат: {0:M}Format: {0:M}

6/15/2009 1:45:30 PM-> 15 июня6/15/2009 1:45:30 PM -> June 15
O либо oO or o Шаблон обратного преобразования даты и времени.Round-trip date/time pattern. Формат: {0:o}Format: {0:o}

6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30.09000006/15/2009 1:45:30 PM -> 2009-06-15T13:45:30.0900000
R либо rR or r Шаблон RFC1123 (Дополнительные сведения см. в разделе DateTimeFormatInfo.RFC1123Pattern ).RFC1123 pattern (for information, see DateTimeFormatInfo.RFC1123Pattern). Формат: {0:R}Format: {0:R}

6/15/2009 1:45:30 PM -> Mon, 15 Jun 2009 20:45:30 GMT6/15/2009 1:45:30 PM -> Mon, 15 Jun 2009 20:45:30 GMT
s Сортируемый шаблон времени и даты.Sortable date/time pattern. Формат: {0:s}Format: {0:s}

6/15/2009 1:45:30 PM -> 2009-06-15T13:45:306/15/2009 1:45:30 PM -> 2009-06-15T13:45:30
t Короткий шаблон времени.Short time pattern. Формат: {0:t}Format: {0:t}

6/15/2009 1:45:30 PM-> 1:45 PM6/15/2009 1:45:30 PM -> 1:45 PM
T Полный шаблон времени.Long time pattern. Формат: {0:T}Format: {0:T}

6/15/2009 1:45:30 PM-> 1:45:30 PM6/15/2009 1:45:30 PM -> 1:45:30 PM
u Универсальный сортируемый шаблон времени и даты.Universal sortable date/time pattern. Формат: {0:u}Format: {0:u}

6/15/2009 1:45:30 PM -> 2009-06-15 20:45:30Z6/15/2009 1:45:30 PM -> 2009-06-15 20:45:30Z
U Универсальный полный шаблон даты и времени.Universal full date/time pattern. Формат: {0:U}Format: {0:U}

6/15/2009 1:45:30 PM-> понедельник, 15 июня 2009 8:45:306/15/2009 1:45:30 PM -> Monday, June 15, 2009 8:45:30 PM
Y либо yY or y Шаблон месяца года.Year month pattern. Формат: {0:Y}Format: {0:Y}

6/15/2009 1:45:30 PM-> Июнь, 20096/15/2009 1:45:30 PM -> June, 2009

Дополнительные сведения и примеры, демонстрирующие форматирование других значений языка и региональных параметров, см. в разделе строки стандартных форматов даты и времени.For more information and for examples that show formatting for other culture values, see Standard Date and Time Format Strings. Можно также создавать строки настраиваемых форматов даты и времени.You can also create custom date and time format strings. Дополнительные сведения см. в разделе строки настраиваемых форматов даты и времени.For more information, see Custom Date and Time Format Strings.

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

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