내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

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

2013-12-13

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

Namespace:  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의 [87b7d528-73f6-43c6-b71a-f23043039a49]을 사용하여 개체 값을 해당 문자열 표현으로 변환하고 이 표현을 문자열에 포함합니다. .NET Framework에서는 광범위한 형식 기능을 지원합니다. 이러한 지원에 대한 자세한 내용은 데스크톱 앱용 .NET Framework 설명서에서 다음 형식 항목을 참조하세요.

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

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

{index[,length][:formatString]}

대괄호로 묶인 요소는 선택적입니다. 다음 표에서는 각 요소에 대해 설명합니다. 형식 항목의 구문을 비롯한 합성 형식 지정 기능에 대한 자세한 내용은 [87b7d528-73f6-43c6-b71a-f23043039a49]을 참조하세요.

요소

설명

index

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

,length

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

:formatString

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

참고참고:

날짜 및 시간 값과 함께 사용되는 표준 및 사용자 지정 형식 문자열에 대해서는 [bb79761a-ca08-44ee-b142-b06b3e2fc22b][98b374e3-0cc2-4c78-ab44-efb671d71984]을 참조하세요. 숫자 값과 함께 사용되는 표준 및 사용자 지정 형식 문자열에 대해서는 [580e57eb-ac47-4ffd-bccd-3a1637c2f467][6f74fd32-6c6b-48ed-8241-3c2b86dea5f4]을 참조하세요. 열거형과 함께 사용되는 표준 형식 문자열의 경우에는 [dd1ff672-1052-42cf-8666-4924fb6cd1a1]을 참조하세요.

앞과 뒤에 사용하는 중괄호 문자 '{' 및 '}'가 필요합니다. 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)


Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

표시:
© 2014 Microsoft