Guid.ParseExact 메서드

정의

네임스페이스:

System

어셈블리:

System.Runtime.dll

오버로드

ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	문자열이 지정된 서식인 경우 GUID의 문자 범위 표현을 해당 Guid 구조체로 변환합니다.
ParseExact(String, String)	문자열이 지정된 서식인 경우 GUID의 문자열 표현을 해당 Guid 구조체로 변환합니다.

ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

Source:

Guid.cs

문자열이 지정된 서식인 경우 GUID의 문자 범위 표현을 해당 Guid 구조체로 변환합니다.

public:
 static Guid ParseExact(ReadOnlySpan<char> input, ReadOnlySpan<char> format);

public static Guid ParseExact (ReadOnlySpan<char> input, ReadOnlySpan<char> format);

static member ParseExact : ReadOnlySpan<char> * ReadOnlySpan<char> -> Guid

Public Shared Function ParseExact (input As ReadOnlySpan(Of Char), format As ReadOnlySpan(Of Char)) As Guid

매개 변수

input

ReadOnlySpan<Char>

변환할 GUID를 나타내는 문자를 포함하는 읽기 전용 범위입니다.

format

ReadOnlySpan<Char>

input을 해석할 때 사용할 정확한 형식을 나타내는 다음 지정자 중 하나를 나타내는 읽기 전용 문자 범위입니다. "N", "D", "B", "P" 또는 "X".

반환

Guid

구문 분석된 값을 포함하는 구조체입니다.

설명

메서드를 ParseExact 사용하려면 선행 및 후행 공백 문자가 제거된 후 매개 변수에서 format 지정한 형식으로 변환하려면 읽기 전용 문자 범위가 필요합니다. 다음 표에서는 매개 변수에 허용되는 format 형식 지정자를 보여줍니다. "0"은 숫자를 나타냅니다. 하이픈("-"), 중괄호("{", "}") 및 괄호("(", ")")가 표시된 것처럼 표시됩니다.

지정자	매개 변수의 input 형식
N	326진수: 00000000000000000000000000000000
D	하이픈으로 구분된 326진수: 00000000-0000-0000-0000-000000000000
b	하이픈으로 구분된 32개의 16진수 숫자로 중괄호로 묶습니다. {00000000-0000-0000-0000-000000000000}
P	괄호로 묶인 하이픈으로 구분된 326진수: (00000000-0000-0000-0000-000000000000)
X	중괄호로 묶인 4개의 16진수 값입니다. 여기서 네 번째 값은 중괄호로 묶인 8개의 16진수 값의 하위 집합입니다. {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

ParseExact(String, String)

Source:

Guid.cs

문자열이 지정된 서식인 경우 GUID의 문자열 표현을 해당 Guid 구조체로 변환합니다.

public:
 static Guid ParseExact(System::String ^ input, System::String ^ format);

public static Guid ParseExact (string input, string format);

static member ParseExact : string * string -> Guid

Public Shared Function ParseExact (input As String, format As String) As Guid

매개 변수

input

String

변환할 GUID.

format

String

input을 해석할 때 사용할 정확한 서식을 나타내는 지정자 "N", "D", "B", "P", "X" 중 하나입니다.

반환

Guid

구문 분석된 값을 포함하는 구조체입니다.

예외

ArgumentNullException

input 또는 format가 null인 경우

FormatException

input은 format에 지정된 형식에 없습니다.

예제

다음 예제에서는 지원되는 각 형식 지정자를 사용하여 메서드를 호출 ToString(String) 하여 단일 GUID를 나타내는 문자열 배열을 생성합니다. 그런 다음 메서드에 ParseExact 전달되어 "B" 형식 지정자를 준수하는 문자열만 성공적으로 구문 분석합니다.

// Define an array of all format specifiers.
string[] formats = { "N", "D", "B", "P", "X" };
Guid guid = Guid.NewGuid();
// Create an array of valid Guid string representations.
var stringGuids = new string[formats.Length];
for (int ctr = 0; ctr < formats.Length; ctr++)
    stringGuids[ctr] = guid.ToString(formats[ctr]);

// Parse the strings in the array using the "B" format specifier.
foreach (var stringGuid in stringGuids)
{
    try
    {
        Guid newGuid = Guid.ParseExact(stringGuid, "B");
        Console.WriteLine($"Successfully parsed {stringGuid}");
    }
    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:
//
//    Bad Format: eb5c8c7d187a44e68afb81e854c39457
//    Bad Format: eb5c8c7d-187a-44e6-8afb-81e854c39457
//    Successfully parsed {eb5c8c7d-187a-44e6-8afb-81e854c39457}
//    Bad Format: (eb5c8c7d-187a-44e6-8afb-81e854c39457)
//    Bad Format: {0xeb5c8c7d,0x187a,0x44e6,{0x8a,0xfb,0x81,0xe8,0x54,0xc3,0x94,0x57}}

open System

// Define an array of all format specifiers.
let formats =
    [| "N"; "D"; "B"; "P"; "X" |]

let guid = Guid.NewGuid()

// Create an array of valid Guid string representations.
let stringGuids = 
    Array.map guid.ToString formats

// Parse the strings in the array using the "B" format specifier.
for stringGuid in stringGuids do
    try
        let newGuid = Guid.ParseExact(stringGuid, "B")
        printfn $"Successfully parsed {stringGuid}"
    with
    | :? ArgumentNullException ->
        printfn "The string to be parsed is null."
    | :? FormatException ->
        printfn $"Bad Format: {stringGuid}"

// The example displays output similar to the following:
//
//    Bad Format: eb5c8c7d187a44e68afb81e854c39457
//    Bad Format: eb5c8c7d-187a-44e6-8afb-81e854c39457
//    Successfully parsed {eb5c8c7d-187a-44e6-8afb-81e854c39457}
//    Bad Format: (eb5c8c7d-187a-44e6-8afb-81e854c39457)
//    Bad Format: {0xeb5c8c7d,0x187a,0x44e6,{0x8a,0xfb,0x81,0xe8,0x54,0xc3,0x94,0x57}}

Module Example
   Public Sub Main()
      ' Define an array of all format specifiers.
      Dim formats() As String = { "N", "D", "B", "P", "X" }
      Dim guid As Guid = Guid.NewGuid()
      ' Create an array of valid Guid string representations.
      Dim stringGuids(formats.Length - 1) As String
      For ctr As Integer = 0 To formats.Length - 1
         stringGuids(ctr) = guid.ToString(formats(ctr))
      Next

      ' Parse the strings in the array using the "B" format specifier.
      For Each stringGuid In stringGuids
         Try
            Dim newGuid As Guid = Guid.ParseExact(stringGuid, "B")
            Console.WriteLine("Successfully parsed {0}", 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:
'    Bad Format: 3351d3f0006747089ff928b5179b2051
'    Bad Format: 3351d3f0-0067-4708-9ff9-28b5179b2051
'    Successfully parsed {3351d3f0-0067-4708-9ff9-28b5179b2051}
'    Bad Format: (3351d3f0-0067-4708-9ff9-28b5179b2051)
'    Bad Format: {0x3351d3f0,0x0067,0x4708,{0x9f,0xf9,0x28,0xb5,0x17,0x9b,0x20,0x51}}

설명

메서드를 ParseExact 사용하려면 선행 및 후행 공백 문자가 제거된 후 문자열이 매개 변수에 format 지정된 형식으로 정확하게 변환되어야 합니다. 다음 표에서는 매개 변수에 허용되는 format 형식 지정자를 보여줍니다. "0"은 숫자를 나타냅니다. 하이픈("-"), 중괄호("{", "}") 및 괄호("(", ")")가 표시된 것처럼 표시됩니다.

지정자	매개 변수의 input 형식
N	326진수: 00000000000000000000000000000000
D	하이픈으로 구분된 326진수: 00000000-0000-0000-0000-000000000000
b	하이픈으로 구분된 32개의 16진수 숫자로 중괄호로 묶습니다. {00000000-0000-0000-0000-000000000000}
P	괄호로 묶인 하이픈으로 구분된 326진수: (00000000-0000-0000-0000-000000000000)
X	중괄호로 묶인 4개의 16진수 값입니다. 여기서 네 번째 값은 중괄호로 묶인 8개의 16진수 값의 하위 집합입니다. {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

추가 정보

• TryParseExact(String, String, Guid)