이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

StringBuilder::AppendFormat 메서드 (String^, Object^)

 

게시 날짜: 2016년 11월

서식 항목이 0개 이상 포함된 복합 서식 문자열을 처리하여 반환된 문자열을 이 인스턴스에 추가합니다. 각 서식 항목이 단일 인수의 문자열 표현으로 바뀝니다.

네임스페이스:   System.Text
어셈블리:  mscorlib(mscorlib.dll에 있음)

public:
StringBuilder^ AppendFormat(
	String^ format,
	Object^ arg0
)

매개 변수

format
Type: System::String^

합성 형식 문자열입니다(설명 부분 참조).

arg0
Type: System::Object^

서식을 지정할 개체입니다.

반환 값

Type: System.Text::StringBuilder^

format이 추가된 이 인스턴스에 대한 참조입니다. format의 각 서식 항목이 arg0의 문자열 표현으로 바뀝니다.

Exception Condition
ArgumentNullException

formatnull인 경우

FormatException

format이 잘못되었습니다.

또는

형식 항목의 인덱스는 0 (영) 보다 작고 또는 1 보다 크거나 합니다.

ArgumentOutOfRangeException

확장된 문자열의 길이가 MaxCapacity를 초과합니다.

이 메서드는 사용 된 합성 서식 지정 기능 텍스트 표현으로는 개체의 값을 변환 하 고 현재에서 표현을 포함 하는.NET Framework의 StringBuilder 개체입니다.

format 0 매개 변수 구성 되거나 더 많은 텍스트로 0 개 이상의 인덱싱된 자리 표시자를 서식 항목 이라고 합니다. 형식 항목의 인덱스에 맞게 0 이어야 합니다. arg0, 이 메서드의 매개 변수 목록에 있는 단일 개체입니다. 포맷 프로세스의 문자열 표현으로 각 형식 항목을 대체 arg0합니다.

형식 항목의 구문은 다음과 같습니다.

{인덱스[,길이] [:formatString]}

대괄호 안의 요소는 선택 사항입니다. 다음 표에서 각 요소에 설명 합니다.

요소

설명

인덱스입니다.

서식을 지정할 개체의 0부터 시작 위치 매개 변수 목록에서입니다. 지정 하는 개체가 경우 인덱스null, 형식 항목으로 대체 됩니다 String::Empty합니다. 매개 변수가 없는 경우는 인덱스 위치는 FormatException 이 throw 됩니다.

길이

매개 변수의 문자열 표현에 있는 문자의 최소 개수입니다. 양수는 매개 변수는 오른쪽에 맞춰집니다. 음수 이면를 왼쪽에 맞춥니다.

:formatString

매개 변수에서 지원 되는 표준 또는 사용자 지정 형식 문자열입니다.

System_CAPS_note참고

날짜 및 시간 값과 함께 사용 되는 표준 및 사용자 지정 형식 문자열을 참조 하십시오. 표준 날짜 및 시간 형식 문자열사용자 지정 날짜 및 시간 형식 문자열합니다. 숫자 값에 사용 되는 표준 및 사용자 지정 형식 문자열을 참조 하십시오. 표준 숫자 형식 문자열사용자 지정 숫자 형식 문자열합니다. 열거형과 함께 사용 되는 표준 형식 문자열에 대 한 참조 열거형 형식 문자열합니다.

arg0 서식을 지정할 개체를 나타냅니다. 각 서식 항목 format 의 문자열 표현으로 바뀝니다 arg0합니다. 형식 항목이 포함 되어 있는 경우 formatStringarg0 구현 하는 IFormattable 인터페이스를 다음 arg0.ToString(formatString, null) 서식을 정의 합니다. 그렇지 않으면 arg0.ToString() 서식을 정의 합니다.

에 할당 된 문자열이 format 는 "기부 해 주셔서 {0: # # #} 캔을 저희 자선 기구에."arg0 는 정수 값 10 이면 반환 값은 "10 캔을 저희 자선 기구에 기부 해 주셔서 감사 합니다." 됩니다

호출자 참고 사항:

에.NET Framework 4 및 .NET Framework 4.5, 를 인스턴스화할 때는 StringBuilder 를 호출 하 여 개체는 StringBuilder(Int32, Int32) 생성자, 길이 및의 용량이 모두는 StringBuilder 인스턴스 값 이상으로 증가할 수 해당 MaxCapacity 속성. 특히 호출 하는 경우 발생할 수 있습니다는 AppendAppendFormat 작은 문자열을 추가 하는 방법입니다.

다음 예제는 AppendFormat 메서드.

using namespace System;
using namespace System::Text;
using namespace System::Globalization;
void Show( StringBuilder^ sbs )
{
   Console::WriteLine( sbs );
   sbs->Length = 0;
}

int main()
{
   StringBuilder^ sb = gcnew StringBuilder;
   int var1 = 111;
   float var2 = 2.22F;
   String^ var3 = "abcd";
   array<Object^>^var4 = {3,4.4,(Char)'X'};
   Console::WriteLine();
   Console::WriteLine( "StringBuilder.AppendFormat method:" );
   sb->AppendFormat( "1) {0}", var1 );
   Show( sb );
   sb->AppendFormat( "2) {0}, {1}", var1, var2 );
   Show( sb );
   sb->AppendFormat( "3) {0}, {1}, {2}", var1, var2, var3 );
   Show( sb );
   sb->AppendFormat( "4) {0}, {1}, {2}", var4 );
   Show( sb );
   CultureInfo^ ci = gcnew CultureInfo( "es-ES",true );
   array<Object^>^temp1 = {var2};
   sb->AppendFormat( ci, "5) {0}", temp1 );
   Show( sb );
}

/*
This example produces the following results:

StringBuilder.AppendFormat method:
1) 111
2) 111, 2.22
3) 111, 2.22, abcd
4) 3, 4.4, X
5) 2,22
*/

유니버설 Windows 플랫폼
10 이후 사용 가능
.NET Framework
1.1 이후 사용 가능
맨 위로 이동
표시: