DisplayFormatAttribute.DataFormatString Свойство

Определение

Пространство имен:

System.ComponentModel.DataAnnotations

Сборка:

System.ComponentModel.Annotations.dll

Исходный код:

DisplayFormatAttribute.cs

Возвращает или задает формат отображения значения поля.

public:
 property System::String ^ DataFormatString { System::String ^ get(); void set(System::String ^ value); };

public string? DataFormatString { get; set; }

member this.DataFormatString : string with get, set

Public Property DataFormatString As String

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

String

Строка форматирования, определяющая формат отображения поля данных. По умолчанию это пустая строка (""), указывающая на неприменение к значению поля специального форматирования.

Примеры

В следующих примерах показано, как использовать DataFormatString свойство для задания формата отображения полей данных. В первом примере задается формат отображения для поля данных типа валюты. Во втором примере задается формат отображения для поля данных типа даты.

// Display currency data field in the format $1,345.50.
[DisplayFormat(DataFormatString="{0:C}")]
public object StandardCost;

' Display currency data field in the format such as $1,345.50.
<DisplayFormat(DataFormatString:="{0:C}")> _
Public StandardCost As Object

// Display date data field in the short format 11/12/08.
// Also, apply format in edit mode.
[DisplayFormat(ApplyFormatInEditMode=true, DataFormatString = "{0:d}")]
public object SellStartDate;

' Display date data field in the short format such as 11/12/08.
' Also, apply format in edit mode.
<DisplayFormat(ApplyFormatInEditMode:=True, DataFormatString:="{0:d}")> _
Public SellStartDate As Object

Комментарии

Используйте свойство , DataFormatString чтобы указать пользовательский формат отображения для значений, отображаемых в объекте DynamicField . DataFormatString Если свойство не задано, значение поля отображается без специального форматирования. Дополнительные сведения см. в статье Типы форматирования в .NET.

Примечание

DynamicField.HtmlEncode Если свойство имеет значение true, значение поля кодируется в формате HTML в его строковом представлении перед применением строки форматирования. Для некоторых объектов, таких как даты, может потребоваться управлять отображением объекта с помощью строки форматирования. В таких случаях необходимо присвоить свойству DynamicField.HtmlEncode значение false.

По умолчанию строка форматирования применяется к значению поля, только если элемент управления с привязкой к данным, содержащий DynamicField объект, находится в режиме только для чтения. Чтобы применить строку форматирования к значениям полей в режиме редактирования, присвойте свойству ApplyFormatInEditMode значение true.

Строка форматирования может быть любой строкой литерала и обычно включает заполнитель для значения поля. Например, в строке форматирования "Item Value: {0}" значение поля заменяется {0} заполнителем при отображении строки в объекте DynamicField . Оставшаяся часть строки форматирования отображается в виде литерального текста.

Примечание

Если строка форматирования не содержит заполнитель, значение поля из источника данных не включается в окончательный отображаемый текст.

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

• Типы форматирования в .NET