Guid.ToString Guid.ToString Guid.ToString Guid.ToString Method

정의

Guid 구조체의 이 인스턴스 값에 대한 문자열 표현을 반환합니다.Returns a string representation of the value of this instance of the Guid structure.

오버로드

ToString() ToString() ToString() ToString()

레지스트리 형식의 이 인스턴스 값에 대한 문자열 표현을 반환합니다.Returns a string representation of the value of this instance in registry format.

ToString(String) ToString(String) ToString(String) ToString(String)

제공된 서식 지정자에 따라 이 Guid 인스턴스의 값에 대한 문자열 표현을 반환합니다.Returns a string representation of the value of this Guid instance, according to the provided format specifier.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

제공된 서식 지정자 및 문화권별 서식 정보에 따라 Guid 클래스의 이 인스턴스 값에 대한 문자열 표현을 반환합니다.Returns a string representation of the value of this instance of the Guid class, according to the provided format specifier and culture-specific format information.

ToString() ToString() ToString() ToString()

레지스트리 형식의 이 인스턴스 값에 대한 문자열 표현을 반환합니다.Returns a string representation of the value of this instance in registry format.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

반환

Guid의 값은 다음과 같은 "D" 서식 지정자를 사용하여 서식이 지정됩니다.The value of this Guid, formatted by using the "D" format specifier as follows: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

여기에서 GUID의 값은 각각 8개, 4개, 4개, 4개, 12개씩의 소문자 16진수 그룹이 하이픈으로 구분되어 표현됩니다.where the value of the GUID is represented as a series of lowercase hexadecimal digits in groups of 8, 4, 4, 4, and 12 digits and separated by hyphens. 예를 들면, "382c74c3-721d-4f34-80e5-57657b6cbc27"과 같은 값이 반환됩니다.An example of a return value is "382c74c3-721d-4f34-80e5-57657b6cbc27". a부터 f까지의 16진수를 대문자로 변환하려면 반환된 문자열에서 ToUpper() 메서드를 호출합니다.To convert the hexadecimal digits from a through f to uppercase, call the ToUpper() method on the returned string.

설명

이 메서드는 일반적인 사용;에 대 한 충분 한 기본 GUID 형식 제공 그러나이 방법의 다른 버전 사용 하는 format 매개 변수 제공 몇 가지 일반적인 형식으로 변형 합니다.This method provides a default GUID format that is sufficient for typical use; however, other versions of this method that take a format parameter provide a few common format variations.

ToString(String) ToString(String) ToString(String) ToString(String)

제공된 서식 지정자에 따라 이 Guid 인스턴스의 값에 대한 문자열 표현을 반환합니다.Returns a string representation of the value of this Guid instance, according to the provided format specifier.

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

Guid 값의 형식을 지정하는 방법을 나타내는 단일 형식 지정자입니다.A single format specifier that indicates how to format the value of this Guid. format 매개 변수는 "N", "D", "B", "P" 또는 "X"가 될 수 있습니다.The format parameter can be "N", "D", "B", "P", or "X". formatnull이거나 빈 문자열("")인 경우 "D"가 사용됩니다.If format is null or an empty string (""), "D" is used.

반환

Guid의 값이며 지정된 형식의 일련의 소문자 16진수로 표현됩니다.The value of this Guid, represented as a series of lowercase hexadecimal digits in the specified format.

예외

format의 값이 null, 빈 문자열(""), "N", "D", "B" "P" 또는 "X"가 아닌 경우The value of format is not null, an empty string (""), "N", "D", "B", "P", or "X".

설명

다음 표에서 대 한 허용 되는 형식 지정자는 format 매개 변수입니다.The following table shows the accepted format specifiers for the format parameter. "0"은 숫자를;를 나타냅니다. 하이픈 ("-"), 중괄호 ("{0}", "}"), 및 괄호 ("(",")")와 같이 표시 합니다."0" represents a digit; hyphens ("-"), braces ("{", "}"), and parentheses ("(", ")") appear as shown.

지정자Specifier 반환 값의 형식Format of return value
N 32 자리 숫자:32 digits:

0000000000000000000000000000000000000000000000000000000000000000
D 하이픈으로 구분 된 32 자리 숫자:32 digits separated by hyphens:

00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 중괄호로 묶인 하이픈으로 구분 된 32 자리 숫자:32 digits separated by hyphens, enclosed in braces:

{00000000-0000-0000-0000-000000000000}
P 괄호로 묶인 하이픈으로 구분 된 32 자리 숫자:32 digits separated by hyphens, enclosed in parentheses:

(00000000-0000-0000-0000-000000000000)(00000000-0000-0000-0000-000000000000)
X 네 번째 값은 괄호로 묶여 있는 8 개의 16 진수 값의 하위 집합을 중괄호로 묶인 4 개의 16 진수 값:Four hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces:

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

A부터 f는 반환된 된 문자열의 소문자 16 진수입니다.The hexadecimal digits a through f are lowercase in the returned string. 대문자로 변환할를 호출 합니다 String.ToUpper 반환된 된 문자열에서 메서드.To convert them to uppercase, call the String.ToUpper method on the returned string.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

제공된 서식 지정자 및 문화권별 서식 정보에 따라 Guid 클래스의 이 인스턴스 값에 대한 문자열 표현을 반환합니다.Returns a string representation of the value of this instance of the Guid class, according to the provided format specifier and culture-specific format information.

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

Guid 값의 형식을 지정하는 방법을 나타내는 단일 형식 지정자입니다.A single format specifier that indicates how to format the value of this Guid. format 매개 변수는 "N", "D", "B", "P" 또는 "X"가 될 수 있습니다.The format parameter can be "N", "D", "B", "P", or "X". formatnull이거나 빈 문자열("")인 경우 "D"가 사용됩니다.If format is null or an empty string (""), "D" is used.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

(예약됨) 문화권별 서식 지정 정보를 제공하는 개체입니다.(Reserved) An object that supplies culture-specific formatting information.

반환

Guid의 값이며 지정된 형식의 일련의 소문자 16진수로 표현됩니다.The value of this Guid, represented as a series of lowercase hexadecimal digits in the specified format.

구현

예외

format의 값이 null, 빈 문자열(""), "N", "D", "B" "P" 또는 "X"가 아닌 경우The value of format is not null, an empty string (""), "N", "D", "B", "P", or "X".

설명

provider 매개 변수는 나중에 사용 하도록 예약 되어 및이 메서드의 실행에 영향을 주지 않습니다.The provider parameter is reserved for future use and does not contribute to the execution of this method. 전달할 수 있습니다 null 메서드 호출에서 합니다.You can pass null in the method call.

다음 표에서 대 한 허용 되는 형식 지정자는 format 매개 변수입니다.The following table shows the accepted format specifiers for the format parameter. "0"은 숫자를;를 나타냅니다. 하이픈 ("-"), 중괄호 ("{0}", "}"), 및 괄호 ("(",")")와 같이 표시 합니다."0" represents a digit; hyphens ("-"), braces ("{", "}"), and parentheses ("(", ")") appear as shown.

지정자Specifier 반환 값의 형식Format of return value
N 32 자리 숫자:32 digits:

0000000000000000000000000000000000000000000000000000000000000000
D 하이픈으로 구분 된 32 자리 숫자:32 digits separated by hyphens:

00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 중괄호로 묶인 하이픈으로 구분 된 32 자리 숫자:32 digits separated by hyphens, enclosed in braces:

{00000000-0000-0000-0000-000000000000}
P 괄호로 묶인 하이픈으로 구분 된 32 자리 숫자:32 digits separated by hyphens, enclosed in parentheses:

(00000000-0000-0000-0000-000000000000)(00000000-0000-0000-0000-000000000000)
X 네 번째 값은 괄호로 묶여 있는 8 개의 16 진수 값의 하위 집합을 중괄호로 묶인 4 개의 16 진수 값:Four hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces:

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

A부터 f는 반환된 된 문자열의 소문자 16 진수입니다.The hexadecimal digits a through f are lowercase in the returned string. 대문자로 변환할를 호출 합니다 String.ToUpper 반환된 된 문자열에서 메서드.To convert them to uppercase, call the String.ToUpper method on the returned string.

때문에 provider 매개 변수는, 사용자 지정 형식 지정 솔루션을 제공 하기 사용할 수 없습니다.Because the provider parameter is ignored, you cannot use it to provide a custom formatting solution. 나타내는 Guid 표준 GUID 형식 문자열을 호출 하 여 지원 되지 않는 형식으로 문자열의에서 값을 String.Format(IFormatProvider, String, Object[]) 메서드를 provider 둘 다 구현 하는 개체를 ICustomFormatterIFormatProvider 인터페이스.To represent a Guid value as a string in a format that isn't supported by the standard GUID format strings, call the String.Format(IFormatProvider, String, Object[]) method with a provider object that implements both the ICustomFormatter and IFormatProvider interfaces. 자세한 내용은 "사용자 지정 서식을 사용 하 여 ICustomFormatter" 섹션을 참조 합니다 형식 문서.For more information, see the "Custom Formatting with ICustomFormatter" section in the Formatting Types article.

적용 대상