Guid.ToString 메서드

정의

네임스페이스:

System

어셈블리:

System.Runtime.dll

Guid 구조체의 이 인스턴스 값에 대한 문자열 표현을 반환합니다.

오버로드

ToString(String, IFormatProvider)	제공된 서식 지정자 및 문화권별 서식 정보에 따라 Guid 클래스의 이 인스턴스 값에 대한 문자열 표현을 반환합니다.
ToString()	레지스트리 형식의 이 인스턴스 값에 대한 문자열 표현을 반환합니다.
ToString(String)	제공된 서식 지정자에 따라 이 Guid 인스턴스의 값에 대한 문자열 표현을 반환합니다.

ToString(String, IFormatProvider)

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

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);

public string ToString (string? format, IFormatProvider? provider);

override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, provider As IFormatProvider) As String

매개 변수

format

String

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

provider

IFormatProvider

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

반환

String

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

구현

ToString(String, IFormatProvider)

예외

FormatException

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}}

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

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

ToString()

레지스트리 형식의 이 인스턴스 값에 대한 문자열 표현을 반환합니다.

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

반환

String

이 Guid의 값은 다음과 같은 "D" 서식 지정자를 사용하여 서식이 지정됩니다.

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

여기에서 GUID의 값은 각각 8개, 4개, 4개, 4개, 12개씩의 소문자 16진수 그룹이 하이픈으로 구분되어 표현됩니다. 예를 들면, "382c74c3-721d-4f34-80e5-57657b6cbc27"과 같은 값이 반환됩니다. a부터 f까지의 16진수를 대문자로 변환하려면 반환된 문자열에서 ToUpper() 메서드를 호출합니다.

설명

이 메서드는 일반적인 사용에 충분한 기본 GUID 형식을 제공합니다. 그러나 매개 변수를 사용하는 format 이 메서드의 다른 버전은 몇 가지 일반적인 형식 변형을 제공합니다.

ToString(String)

제공된 서식 지정자에 따라 이 Guid 인스턴스의 값에 대한 문자열 표현을 반환합니다.

public:
 System::String ^ ToString(System::String ^ format);

public string ToString (string? format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

매개 변수

format

String

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

반환

String

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

예외

FormatException

format의 값이 null, 빈 문자열(""), "N", "D", "B" "P" 또는 "X"가 아닌 경우

설명

다음 표에서는 매개 변수에 허용되는 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}}

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