Guid.Parse 메서드

정의

오버로드

Parse(String)

GUID의 문자열 표현을 해당 Guid 구조체로 변환합니다.Converts the string representation of a GUID to the equivalent Guid structure.

Parse(ReadOnlySpan<Char>)

GUID를 나타내는 읽기 전용 문자 범위를 해당하는 Guid 구조체로 변환합니다.Converts a read-only character span that represents a GUID to the equivalent Guid structure.

Parse(String)

GUID의 문자열 표현을 해당 Guid 구조체로 변환합니다.Converts the string representation of a GUID to the equivalent Guid structure.

public:
 static Guid Parse(System::String ^ input);
public static Guid Parse (string input);
static member Parse : string -> Guid
Public Shared Function Parse (input As String) As Guid

매개 변수

input
String

변환할 문자열입니다.The string to convert.

반환

구문 분석된 값을 포함하는 구조체입니다.A structure that contains the value that was parsed.

예외

input이(가) null인 경우input is null.

input의 형식을 인식할 수 없는 경우input is not in a recognized format.

예제

다음 예제에서는 새 GUID를 만들고, "B", "D" 및 "X" 형식 지정자를 사용 하 여 ToString(String) 메서드를 호출한 다음 Parse 메서드를 호출 하 여 문자열을 Guid 값으로 다시 변환 합니다.The following example creates a new GUID, converts it to three separate string representations by calling the ToString(String) method with the "B", "D", and "X" format specifiers, and then calls the Parse method to convert the strings back to Guid values.

var originalGuid = Guid.NewGuid();
// Create an array of string representations of the GUID.
string[] stringGuids = { originalGuid.ToString("B"),
                         originalGuid.ToString("D"),
                         originalGuid.ToString("X") };

// Parse each string representation.
foreach (var stringGuid in stringGuids)
{
    try
    {
        Guid newGuid = Guid.Parse(stringGuid);
        Console.WriteLine($"Converted {stringGuid} to a Guid");
    }   
    catch (ArgumentNullException)
    {
        Console.WriteLine("The string to be parsed is null.");   
    }
    catch (FormatException)
    {
        Console.WriteLine($"Bad format: {stringGuid}");
    }
}

// The example displays output similar to the following:
//
//    Converted {81a130d2-502f-4cf1-a376-63edeb000e9f} to a Guid
//    Converted 81a130d2-502f-4cf1-a376-63edeb000e9f to a Guid
//    Converted {0x81a130d2,0x502f,0x4cf1,{0xa3,0x76,0x63,0xed,0xeb,0x00,0x0e,0x9f}} to a Guid
Module Example
   Public Sub Main()
      Dim originalGuid As Guid = Guid.NewGuid()
      ' Create an array of string representations of the GUID.
      Dim stringGuids() As String = { originalGuid.ToString("B"),
                                      originalGuid.ToString("D"),
                                      originalGuid.ToString("X") }
      
      ' Parse each string representation.
      For Each stringGuid In stringGuids
         Try 
            Dim newGuid As Guid = Guid.Parse(stringGuid) 
            Console.WriteLine("Converted {0} to a Guid", stringGuid)
         Catch e As ArgumentNullException
            Console.WriteLine("The string to be parsed is null.")   
         Catch e As FormatException
            Console.WriteLine("Bad format: {0}", stringGuid)
         End Try     
      Next                                      
   End Sub
End Module
' The example displays the following output:
'    Converted {81a130d2-502f-4cf1-a376-63edeb000e9f} to a Guid
'    Converted 81a130d2-502f-4cf1-a376-63edeb000e9f to a Guid
'    Converted {0x81a130d2,0x502f,0x4cf1,{0xa3,0x76,0x63,0xed,0xeb,0x00,0x0e,0x9f}} to a Guid

설명

Parse 메서드는 input에서 선행 또는 후행 공백을 자르고 GUID의 문자열 표현을 Guid 값으로 변환 합니다.The Parse method trims any leading or trailing white space from input and converts the string representation of a GUID to a Guid value. 이 메서드는 다음 표에 나와 있는 것 처럼 ToString(String)ToString(String, IFormatProvider) 메서드에서 생성 된 5 가지 형식으로 문자열을 변환할 수 있습니다.This method can convert strings in any of the five formats produced by the ToString(String) and ToString(String, IFormatProvider) methods, as shown in the following table.

지정자Specifier 설명Description 서식Format
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}}

메서드는 문자열을 성공적으로 구문 분석할 수 없는 경우 FormatException을 throw 합니다.The method throws a FormatException if it is unable to successfully parse the string. 이 문제가 발생 하는 이유는 다음과 같습니다.Here are some of the reasons why this might occur include:

  • input에 16 진수 문자 집합에 포함 되지 않은 문자가 포함 되어 있습니다.input contains characters that are not part of the hexadecimal character set.

  • input의 숫자가 너무 많거나 너무 적습니다.input has too many or too few numeric characters.

  • input에 특정 형식에 적합 한 숫자가 너무 많거나 너무 적습니다.input has too many or too few of the non-numeric characters appropriate for a particular format.

  • inputToString 메서드에서 인식 하 고 이전 표에 나와 있는 형식 중 하나가 아닙니다.input is not in one of the formats recognized by the ToString method and listed in the previous table.

예외를 처리 하지 않고 TryParse 메서드를 사용 하 여 실패 한 구문 분석 작업을 catch 합니다.Use the TryParse method to catch any unsuccessful parse operations without having to handle an exception.

추가 정보

Parse(ReadOnlySpan<Char>)

GUID를 나타내는 읽기 전용 문자 범위를 해당하는 Guid 구조체로 변환합니다.Converts a read-only character span that represents a GUID to the equivalent Guid structure.

public:
 static Guid Parse(ReadOnlySpan<char> input);
public static Guid Parse (ReadOnlySpan<char> input);
static member Parse : ReadOnlySpan<char> -> Guid
Public Shared Function Parse (input As ReadOnlySpan(Of Char)) As Guid

매개 변수

input
ReadOnlySpan<Char>

GUID를 나타내는 바이트를 포함하는 읽기 전용 범위입니다.A read-only span containing the bytes representing a GUID.

반환

구문 분석된 값을 포함하는 구조체입니다.A structure that contains the value that was parsed.

예외

input의 형식을 인식할 수 없는 경우input is not in a recognized format.

또는-or-

트리밍 후 읽기 전용 문자 범위의 길이는 0입니다.After trimming, the length of the read-only character span is 0.

설명

Parse 메서드는 input에서 선행 또는 후행 공백 문자를 자르고 input의 나머지 문자를 Guid 값으로 변환 합니다.The Parse method trims any leading or trailing white space characters from input and converts the remaining characters in input to a Guid value. 이 메서드는 다음 표에 나와 있는 것 처럼 ToString 메서드에서 생성 된 5 가지 형식 중 하나를 나타내는 문자 범위를 변환할 수 있습니다.This method can convert a character span that represents any of the five formats produced by the ToString methods, as shown in the following table.

지정자Specifier 설명Description 서식Format
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}}

메서드는 문자열을 성공적으로 구문 분석할 수 없는 경우 FormatException을 throw 합니다.The method throws a FormatException if it is unable to successfully parse the string. 이 문제가 발생 하는 이유는 다음과 같습니다.Here are some of the reasons why this might occur include:

  • input에 16 진수 문자 집합에 포함 되지 않은 문자가 포함 되어 있습니다.input contains characters that are not part of the hexadecimal character set.

  • input의 숫자가 너무 많거나 너무 적습니다.input has too many or too few numeric characters.

  • input에 특정 형식에 적합 한 숫자가 너무 많거나 너무 적습니다.input has too many or too few of the non-numeric characters appropriate for a particular format.

  • inputToString 메서드에서 인식 하 고 이전 표에 나와 있는 형식 중 하나가 아닙니다.input is not in one of the formats recognized by the ToString method and listed in the previous table.

예외를 처리 하지 않고 TryParse 메서드를 사용 하 여 실패 한 구문 분석 작업을 catch 합니다.Use the TryParse method to catch any unsuccessful parse operations without having to handle an exception.

적용 대상