DisplayFormatAttribute.DataFormatString 속성

정의

네임스페이스:

System.ComponentModel.DataAnnotations

어셈블리:

System.ComponentModel.Annotations.dll

Source:

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 속성을 설정하지 않으면 특수 서식 없이 필드 값이 표시됩니다. 자세한 내용은 서식 지정 형식을 참조하세요.

메모

DynamicField.HtmlEncode 속성이 있으면 true서식 문자열이 적용되기 전에 필드 값이 해당 문자열 표현으로 HTML로 인코딩됩니다. 날짜와 같은 일부 개체의 경우 서식 문자열을 사용하여 개체가 표시되는 방식을 제어할 수 있습니다. 이러한 경우 속성을 false.로 설정 DynamicField.HtmlEncode 해야 합니다.

기본적으로 서식 문자열은 개체를 포함하는 데이터 바인딩된 컨트롤이 읽기 전용 모드인 경우에만 필드 값에 적용됩니다 DynamicField . 편집 모드에 있을 때 필드 값에 서식 문자열을 적용하려면 속성을 true.로 설정합니다ApplyFormatInEditMode.

서식 문자열은 모든 리터럴 문자열일 수 있으며 일반적으로 필드 값에 대한 자리 표시자를 포함합니다. 예를 들어 서식 문자열 "Item Value: {0}"에서 문자열이 개체에 {0} 표시될 때 필드의 값이 자리 표시자로 대체됩니다 DynamicField . 서식 문자열의 나머지 부분에서는 리터럴 텍스트로 표시됩니다.

메모

서식 문자열에 자리 표시자가 포함되어 있지 않으면 데이터 원본의 필드 값이 최종 표시 텍스트에 포함되지 않습니다.

추가 정보

• .NET의 형식 서식 지정