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의 서식 지정 형식