내보내기(0) 인쇄
모두 확장
이 문서는 기계로 번역한 것입니다. 원본 텍스트를 보려면 포인터를 문서의 문장 위로 올리십시오. 추가 정보
번역
원본

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

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

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

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

매개 변수

format
형식: System::String
합성 형식 문자열입니다(설명 부분 참조).
arg0
형식: System::Object
형식을 지정할 개체입니다.

반환 값

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

예외조건
ArgumentNullException

formatNull 참조(Visual Basic의 경우 Nothing)입니다.

FormatException

format이(가) 잘못되었습니다.

또는

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

ArgumentOutOfRangeException

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

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

format 매개 변수는 형식 항목으로 불리는 0개 이상의 인덱싱된 자리 표시자와 결합된 0개 이상의 텍스트 실행으로 구성됩니다. 형식 항목의 인덱스는 arg0가 되는 이 메서드의 매개 변수 목록의 단일 개체에 일치하기 위해 0 이어야 합니다. 프로세스 서식을 지정하면 각 형식 항목이 arg0의 문자열 표현으로 바뀝니다.

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

{index[,length][:formatString]}

대괄호로 묶인 요소는 선택적입니다. 다음 표에서는 각 요소에 대해 설명합니다.

요소

설명

인덱스입니다.

형식을 지정할 개체의 매개 변수 목록 위치(0부터 시작)입니다. index로 지정된 개체가 Null 참조(Visual Basic의 경우 Nothing)이면 형식 항목이 String::Empty로 대체됩니다. index 위치에 매개 변수가 없는 경우 FormatException이 throw됩니다.

,length

매개 변수의 문자열 표현에 포함되는 최소 문자 수입니다. 양수이면 매개 변수가 오른쪽에 맞춰지고, 음수이면 왼쪽에 맞춰집니다.

:formatString

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

참고참고

날짜 및 시간 값과 함께 사용되는 표준 및 사용자 지정 형식 문자열의 경우 표준 날짜 및 시간 서식 문자열사용자 지정 날짜 및 시간 형식 문자열을 참조하십시오. 숫자 값과 함께 사용되는 표준 및 사용자 지정 형식 문자열의 경우 표준 숫자 서식 문자열사용자 지정 숫자 서식 문자열을 참조하십시오. 열거형과 함께 사용되는 표준 형식 문자열의 경우 열거형 형식 문자열을 참조하십시오.

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

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

호출자 참고 사항

.NET Framework 4 및 .NET Framework 4.5에서는 StringBuilder(Int32, Int32) 생성자를 호출하여 StringBuilder 개체를 인스턴스화할 때 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
*/


.NET Framework

4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0에서 지원

.NET Framework Client Profile

4, 3.5 SP1에서 지원

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(서버 코어 역할은 지원되지 않음), Windows Server 2008 R2(서버 코어 역할은 SP1 이상에서 지원, Itanium은 지원되지 않음)

.NET Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

커뮤니티 추가 항목

추가
표시:
© 2014 Microsoft