다음을 통해 공유


Guid.IFormattable.ToString(String, IFormatProvider) 메서드

정의

제공된 형식 지정자 및 문화권별 형식 정보에 따라 이 인스턴스 값의 문자열 표현을 반환합니다.

 virtual System::String ^ System.IFormattable.ToString(System::String ^ format, IFormatProvider ^ provider) = IFormattable::ToString;
string IFormattable.ToString (string format, IFormatProvider provider);
abstract member System.IFormattable.ToString : string * IFormatProvider -> string
override this.System.IFormattable.ToString : string * IFormatProvider -> string
Function ToString (format As String, provider As IFormatProvider) As String Implements IFormattable.ToString

매개 변수

format
String

Guid 값의 형식을 지정하는 방법을 나타내는 단일 형식 지정자입니다. format 매개 변수는 "N", "D", "B", "P" 또는 "X"가 될 수 있습니다. format이 null이거나 빈 문자열("")인 경우 "D"가 사용됩니다.

provider
IFormatProvider

(예약됨) 문화권별 서식 지정 정보를 제공하는 개체입니다.

반환

String

Guid의 값이며 지정된 형식의 일련의 소문자 16진수로 표현됩니다.

구현

예외

format의 값은 null, 빈 문자열("") 또는 "N", "D", "B", "P" 또는 "X"와 같은 단일 형식 지정자 중 하나가 아닙니다.

설명

매개 변수는 provider 나중에 사용할 수 있도록 예약되어 있으며 이 메서드의 실행에 영향을 주지 않습니다. 메서드 호출을 전달할 null 수 있습니다.

다음 표에서는 매개 변수에 허용되는 format 형식 지정자를 보여줍니다. "0"은 숫자를 나타냅니다. 하이픈("-"), 중괄호("{", "}") 및 괄호("(", ")")가 표시된 것처럼 나타납니다.

지정자 반환 값 형식
N 32자리 숫자:

00000000000000000000000000000000
D 하이픈으로 구분된 32자리 숫자:

00000000-0000-0000-0000-000000000000
B 하이픈으로 구분된 32자리 숫자( 중괄호로 묶음):

{00000000-0000-0000-0000-000000000000}
P 하이픈으로 구분된 32자리 숫자( 괄호로 묶음):

(00000000-0000-0000-0000-000000000000)
X 중괄호로 묶인 4개의 16진수 값입니다. 여기서 네 번째 값은 중괄호로 묶인 8개의 16진수 값의 하위 집합입니다.

{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

1-f의 16진수 숫자는 반환된 문자열의 소문자입니다. 대문자로 변환하려면 반환된 문자열에서 String.ToUpper 메서드를 호출합니다.

매개 변수는 provider 무시되므로 사용자 지정 서식 지정 솔루션을 제공하는 데 사용할 수 없습니다. 표준 GUID 형식 문자열에서 지원되지 않는 형식의 문자열로 값을 나타내 Guid 려면 인터페이스와 IFormatProvider 인터페이스를 모두 구현하는 개체를 사용하여 provider 메서드를 ICustomFormatter 호출 String.Format(IFormatProvider, String, Object[]) 합니다. 자세한 내용은 서식 형식 문서의 "ICustomFormatter를 사용한 사용자 지정 서식 지정" 섹션 참조하세요.

적용 대상