ListControl.DataTextFormatString 속성

정의

목록 컨트롤에 바인딩된 데이터를 표시하는 방법을 제어하는 데 사용되는 서식 지정 문자열을 가져오거나 설정합니다.Gets or sets the formatting string used to control how data bound to the list control is displayed.

public:
 virtual property System::String ^ DataTextFormatString { System::String ^ get(); void set(System::String ^ value); };
[System.Web.UI.Themeable(false)]
public virtual string DataTextFormatString { get; set; }
member this.DataTextFormatString : string with get, set
Public Overridable Property DataTextFormatString As String

속성 값

컨트롤에 바인딩된 데이터의 서식 지정 문자열입니다.The formatting string for data bound to the control. 기본값은 Empty입니다.The default value is Empty.

특성

설명

사용 하 여는 DataTextFormatString 속성을 사용자 지정 표시 형식을 목록 컨트롤에서 항목을 제공 합니다.Use the DataTextFormatString property to provide a custom display format the items in a list control.

데이터 형식 문자열 형태로 콜론으로 구분 된 두 부분으로 구성 됩니다 { A : Bxx }.The data format string consists of two parts, separated by a colon, in the form { A : Bxx }. 예를 들어 서식 문자열이 {0:F2} 고정된 소수점 두 개의 소수 자릿수로 숫자를 표시할 셀 서식을 지정 합니다.For example, the formatting string {0:F2} would format the cell to display a fixed point number with two decimal places.

참고

전체 문자열 서식 문자열 및 리터럴 문자열이 아닌 것을 나타내기 위해 괄호로 묶어야 합니다.The entire string must be enclosed in braces to indicate that it is a format string and not a literal string. 괄호 밖에 텍스트는 리터럴 텍스트로 표시 됩니다.Any text outside the braces is displayed as literal text.

콜론 앞 값 (A 예:에서) 매개 변수 인덱스가 0부터 시작 하는 매개 변수 목록을 지정 합니다.The value before the colon (A in the general example) specifies the parameter index in a zero-based list of parameters.

참고

각 셀에 값이 하나만 있기 때문에이 값을 0으로 설정할만 있습니다.This value can only be set to 0 because there is only one value in each cell.

콜론 문자 (B 예:에서)의 값을 표시할 형식을 지정 합니다.The character after the colon (B in the general example) specifies the format to display the value in. 다음 표에서 일반 형식을 나열합니다.The following table lists the common formats.

형식 문자Format character 설명Description
C 통화 형식으로 숫자 값을 표시합니다.Displays numeric values in currency format.
D 10 진수 형식의 숫자 값을 표시합니다.Displays numeric values in decimal format.
E 과학적 (지 수)의 숫자 값을 표시합니다.Displays numeric values in scientific (exponential) format.
F 고정 형식으로 숫자 값을 표시합니다.Displays numeric values in fixed format.
G 숫자 값을 표시 일반적 서식을 지정합니다.Displays numeric values in general format.
N 숫자 형식의 숫자 값을 표시합니다.Displays numeric values in number format.
X 16 진수 형식의 숫자 값을 표시합니다.Displays numeric values in hexadecimal format.

참고

형식 문자를 제외 하 고 대 소문자를 구분 하지는 X, 16 진수 문자를 지정 하는 경우를 표시 합니다.The format character is not case-sensitive, except for X, which displays the hexadecimal characters in the case specified.

형식 문자 뒤의 값 (xx 예:에서) 유효 자릿수 또는 소수 자릿수의 수를 지정 합니다.The value after the format character (xx in the general example) specifies the number of significant digits or decimal places to display.

다음 표에서 서식 문자열 및 결과의 예를 보여 줍니다.The following table contains examples of formatting strings and the results. 표준 영어 설정 가정합니다.It assumes standard English settings.

숫자 값Numeric Value 형식 문자열Format String 결과Result
12345.678912345.6789 "{0:C}""{0:C}" $12,345.68$12,345.68
-12345.6789-12345.6789 "{0:C}""{0:C}" ($12,345.68)($12,345.68)
1234512345 "{0:D}""{0:D}" 1234512345
1234512345 "{0:D8}""{0:D8}" 0001234500012345
12345.678912345.6789 "{0:E}""{0:E}" 1234568E+0041234568E+004
12345.678912345.6789 "{0:E10}""{0:E10}" 1.2345678900E+0041.2345678900E+004
12345.678912345.6789 "{0:F}""{0:F}" 12345.6812345.68
12345.678912345.6789 "{0:F0}""{0:F0}" 1234612346
12345.678912345.6789 "{0:G}""{0:G}" 12345.678912345.6789
123456789123456789 "{0:G7}""{0:G7}" 1.234568E81.234568E8
12345.678912345.6789 "{0:N}""{0:N}" 12,345.6812,345.68
123456789123456789 "{0:N4}""{0:N4}" 123,456,789.0000123,456,789.0000
12345.678912345.6789 "총: {0:C}""Total: {0:C}" 합계: $ 12345.68Total: $12345.68

문자열 형식 지정에 대한 자세한 내용은 형식 서식 지정을 참조하세요.For more information on formatting strings, see Formatting Types.

이 속성의 값은 뷰 상태에 저장 됩니다.The value of this property is stored in view state.

이 속성은 테마 또는 스타일시트 테마에 의해 설정될 수 없습니다.This property cannot be set by themes or style sheet themes. 자세한 내용은 ThemeableAttribute 하 고 ASP.NET 테마 및 스킨합니다.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

적용 대상

추가 정보