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

String.Format 메서드 (String, Object[])

지정된 문자열의 형식 항목을 지정된 배열에 있는 해당 개체의 문자열 표현으로 바꿉니다.

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

public static string Format(
	string format,
	params Object[] args
)

매개 변수

format
형식: System.String
합성 형식 문자열입니다(설명 부분 참조).
args
형식: System.Object[]
형식을 지정할 개체를 0개 이상 포함하는 개체 배열입니다.

반환 값

형식: System.String
형식 항목을 args에 있는 해당 개체의 문자열 표현으로 바꾼 format의 복사본입니다.

예외상황
ArgumentNullException

format 또는 argsnull인 경우

FormatException

format이 잘못된 경우

- 또는 -

형식 항목의 인덱스가 0보다 작거나 args 배열의 길이보다 크거나 같은 경우

이 메서드는 .NET Framework의 복합 형식 지정 기능을 사용하여 개체 값을 해당 문자열 표현으로 변환하고 이 표현을 문자열에 포함합니다. .NET Framework에서는 광범위한 형식 지정 기능을 지원합니다. 이러한 지원에 대한 자세한 내용은 다음 형식 지정 항목을 참조하십시오.

format 매개 변수는 이 메서드의 매개 변수 목록에 있는 개체에 해당하는 0개 이상의 인덱싱된 자리 표시자(형식 항목이라고 함)와 결합된 0개 이상의 텍스트로 구성됩니다. 형식 지정 프로세스에서는 각 형식 항목을 해당 개체의 문자열 표현으로 바꿉니다.

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

{index[,length][:formatString]}

대괄호로 묶인 요소는 선택적입니다. 다음 표에서는 각 요소에 대해 설명합니다. 형식 항목의 구문을 비롯한 합성 형식 지정 기능에 대한 자세한 내용은 합성 형식 지정을 참조하십시오.

요소

설명

index

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

,length

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

:formatString

형식을 지정할 개체에서 지원하는 표준 또는 사용자 지정 형식 문자열입니다. formatString의 가능한 값은 해당 개체의 ToString(format) 메서드에서 지원하는 값과 동일합니다. formatString이 지정되어 있지 않고 형식을 지정할 개체가 IFormattable 인터페이스를 구현하는 경우 IFormattable.ToString 형식 문자열로 사용되는 format 매개 변수 값으로 null이 전달됩니다.

참고참고:

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

앞과 뒤에 사용하는 중괄호 문자 '{' 및 '}'가 필요합니다. format에서 단일 리터럴 중괄호 문자를 지정하려면 "{{" 또는 "}}"와 같이 중괄호 문자를 두 개 지정합니다.

format의 값이 "Microsoft® .NET(Core Reference) 제품을 {0:####}개 구매해 주셔서 감사합니다."이고 arg[0]은 값이 123인 Int16이면 반환 값은 다음과 같습니다.

"Microsoft® .NET(Core Reference) 제품을 123개 구매해 주셔서 감사합니다."

format의 값이 "Brad의 개에는 {0,-8:G} 개의 벼룩이 있습니다."이고 arg[0]은 값이 42인 Int16이면 반환 값은 다음과 같습니다. 이 예제에서 밑줄(_)은 안쪽 여백을 나타냅니다.

"Brad의 개에는 42______ 개의 벼룩이 있습니다."

다음 예제에서는 특정 날짜의 최고 온도와 최저 온도에 대한 데이터가 들어 있는 문자열을 만듭니다. 합성 서식 문자열에는 C# 예제에서는 5개, Visual Basic 예제에서는 6개의 형식 항목이 있습니다. 두 가지 형식 항목은 해당하는 값의 문자열 표현의 너비를 정의하며 첫 번째 형식 항목은 표준 날짜 및 시간 형식 문자열도 포함합니다.


using System;

public class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      DateTime date1 = new DateTime(2009, 7, 1);
      TimeSpan hiTime = new TimeSpan(14, 17, 32);
      decimal hiTemp = 62.1m;
      TimeSpan loTime = new TimeSpan(3, 16, 10);
      decimal loTemp = 54.8m;

      string result1 = String.Format("Temperature on {0:d}:\n{1,11}: {2} degrees (hi)\n{3,11}: {4} degrees (lo)",
                                     date1, hiTime, hiTemp, loTime, loTemp);
      outputBlock.Text += result1 + "\n";
      outputBlock.Text += "\n";

      string result2 = String.Format("Temperature on {0:d}:\n{1,11}: {2} degrees (hi)\n{3,11}: {4} degrees (lo)",
                                     new object[] { date1, hiTime, hiTemp, loTime, loTemp });
      outputBlock.Text += result2 + "\n";
   }
}
// The example displays the following output:
//       Temperature on 7/1/2009:
//          14:17:32: 62.1 degrees (hi)
//          03:16:10: 54.8 degrees (lo)
//       Temperature on 7/1/2009:
//          14:17:32: 62.1 degrees (hi)
//          03:16:10: 54.8 degrees (lo)


Silverlight

5, 4, 3에서 지원

Windows Phone용 Silverlight

Windows Phone OS 7.1, Windows Phone OS 7.0에서 지원

XNA Framework

Xbox 360, Windows Phone OS 7.0에서 지원

Silverlight에서 지원되는 운영 체제 및 브라우저에 대한 자세한 내용은 지원되는 운영 체제 및 브라우저을 참조하십시오.

커뮤니티 추가 항목

추가
표시: