다음을 통해 공유

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 Name ProductNumber ListPrice 무게 ModifiedDate
000680 HL Road Frame - Black, 58 #FR-R92B-58 $1,431.50 1016.040 3/11/2004

설명

사용 합니다 DataFormatString 속성에 표시 되는 값에 대 한 사용자 지정 표시 형식을 지정 하는 BoundField 개체입니다. 경우는 DataFormatString 속성이 설정 되지 않은, 특별 한 서식 없이 필드의 값이 표시 됩니다.

참고

3.5 보다 이전 버전의 ASP.NET에서 설정 해야 합니다 HtmlEncode 속성을 false 의 서식을 지정 하려면 필드를 하지 문자열 데이터 형식입니다. 그렇지 않은 경우 필드 값에 저장 된 서식 문자열 앞에 있는 기본 변환 메서드에서 문자열로 변환 됩니다는 DataFormatString 속성이 적용 됩니다.

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

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

서식 문자열에 자리 표시 자가 포함 되어 있지 않으면, 서식 문자열 자체 (데이터 원본의 필드 값 포함 되지 않습니다.) 최종 표시 텍스트에 포함 됩니다. 자리 표시자 앞의 예제와 같이 중괄호로 묶인 0 (영) 인 경우 기본 메서드에서 필드 값을 문자열로 변환 됩니다. 필드 값을 포맷 해야 하는 방법을 지정 하는 문자열을 0에 추가할 수 있습니다. 예를 들어, 자리 표시자 {0:C} 숫자 필드를 필드 값의 통화 형식으로 변환 되어야 함을 지정 합니다.

서식을 사용 하 여 적용 되는 Format 메서드. 왼쪽된 중괄호 뒤에 오는 수가 해당 메서드에서 사용 되는 구문의 부분을 자리 표시자를 사용 해야 하나를 일련의 값을 나타냅니다. 각 셀에서 필드 값이 하나만 있기 때문에 왼쪽된 중괄호 뒤에 오는 숫자 0으로 설정할 수만 있습니다.

다음 표에서 숫자 필드에 대 한 표준 형식 문자를 나열합니다. 이러한 형식 문자를 제외 하 고 대 소문자를 구분 되지 X, 지정 된 경우에서 16 진수 문자를 표시 하는 합니다. 대부분의 서식 문자를 표시 하려면 얼마나 많은 유효 자릿수 또는 소수 자릿수를 지정 하려면 숫자를 추가할 수 있습니다.

참고

대부분의 경우에서 서버의 문화권 설정에 따라 서식 지정 합니다. 문화권 설정에 대 한 예제는 en-US합니다.

형식 문자 Description 예제
C 또는 c 통화 형식으로 숫자 값을 표시합니다. 소수 자릿수를 지정할 수 있습니다. 형식: {0:C}

123.456 -> $123.46

형식: {0:C3}

123.456 -> $123.456
D 또는 d 10 진수 형식의 정수 값을 표시합니다. 소수 자릿수를 지정할 수 있습니다. (형식이 "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}

.5 -> 50.0%
R 또는 r 표시 Single, Double, 또는 BigInteger 라운드트립 형식의 값입니다. 형식: {0:R}

123456789.12345678 -> 123456789.12345678
X 또는 x 16 진수 형식의 정수 값을 표시합니다. 소수 자릿수를 지정할 수 있습니다. 형식: {0:X}

255 -> FF

형식: {0:x4}

255 -> 00ff

자세한 내용을 다른 문화권 값의 서식을 보여 주는 예제는 참조 Standard Numeric Format Strings합니다. 또한 사용자 지정 숫자 서식 문자열을 만들 수 있습니다. 자세한 내용은 사용자 지정 숫자 서식 문자열을 참조하세요.

다음 표에서 형식 문자를 나열 DateTime 필드입니다. 형식 사양 이들 중 대부분 문화권 설정에 따라 다른 출력에서 발생 합니다. 에 대 한 예제는 한 DateTime 2009 년 6 월 15의 값 1시 45분: 30 PM의 문화권 설정 사용 하 여 en-US합니다.

형식 문자 Description 예제
d 간단한 날짜 패턴입니다. 형식: {0:d}

2009 년 6 월 15 오후 1시 45분: 30 2009 년 6 월 15->
D 자세한 날짜 패턴입니다. 형식: {0:D}

2009 년 6 월 15 오후 1시 45분: 30-Monday, 2009년 6월 15일 >
f 전체 날짜/시간 패턴(간단한 시간)입니다. 형식: {0:f}

2009 년 6 월 15 오후 1시 45분: 30-Monday, 2009년 6월 15일 > 1:45 PM
F 전체 날짜/시간 패턴(자세한 시간) 형식: {0:F}

2009 년 6 월 15 오후 1시 45분: 30-Monday, 2009년 6월 15일 > 오후 1시 45분: 30
g 일반 날짜/시간 패턴(간단한 시간) 형식: {0:g}

2009 년 6 월 15 오후 1시 45분: 30 2009 년 6 월 15-> 1:45 PM
G 일반 날짜/시간 패턴(자세한 시간)입니다. 형식: {0:G}

2009 년 6 월 15 오후 1시 45분: 30 2009 년 6 월 15-> 오후 1시 45분: 30
M 또는 m 월/일 패턴입니다. 형식: {0:M}

2009 년 6 월 15 오후 1시 45분: 30 년 6 월 15->
O 또는 o 라운드트립 날짜/시간 패턴입니다. 형식: {0:o}

6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30.0900000
R 또는 r RFC1123 패턴 (내용은 DateTimeFormatInfo.RFC1123Pattern). 형식: {0:R}

6/15/2009 1:45:30 PM -> Mon, 15 Jun 2009 20:45:30 GMT
s 정렬 가능한 날짜/시간 패턴입니다. 형식: {0:s}

6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30
t 간단한 시간 패턴입니다. 형식: {0:t}

2009 년 6 월 15 오후 1시 45분: 30-1:45 PM >
T 자세한 시간 패턴 형식: {0:T}

2009 년 6 월 15 오후 1시 45분: 30 오후 1시 45분: 30->
u 정렬 가능한 유니버설 날짜/시간 패턴 형식: {0:u}

6/15/2009 1:45:30 PM -> 2009-06-15 20:45:30Z
U 유니버설 전체 날짜/시간 패턴입니다. 형식: {0:U}

2009 년 6 월 15 오후 1시 45분: 30-Monday, 2009년 6월 15일 > 오후 8시 45분: 30
Y 또는 y 연도 월 패턴 형식: {0:Y}

2009 년 6 월 15 오후 1시 45분: 30 2009 년 6 월->

자세한 내용을 다른 문화권 값의 서식을 보여 주는 예제는 참조 표준 날짜 및 시간 형식 문자열합니다. 또한 사용자 지정 날짜 및 시간 서식 문자열을 만들 수 있습니다. 자세한 내용은 사용자 지정 날짜 및 시간 형식 문자열을 참조하세요.

적용 대상

추가 정보