Guid.TryParse 메서드

정의

오버로드

TryParse(ReadOnlySpan<Char>, Guid)

GUID의 표현을 포함하는 지정된 읽기 전용 문자 범위를 해당하는 Guid 구조체로 변환합니다.Converts the specified read-only span of characters containing the representation of a GUID to the equivalent Guid structure.

TryParse(String, Guid)

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

TryParse(ReadOnlySpan<Char>, Guid)

GUID의 표현을 포함하는 지정된 읽기 전용 문자 범위를 해당하는 Guid 구조체로 변환합니다.Converts the specified read-only span of characters containing the representation of a GUID to the equivalent Guid structure.

public:
 static bool TryParse(ReadOnlySpan<char> input, [Runtime::InteropServices::Out] Guid % result);
public static bool TryParse (ReadOnlySpan<char> input, out Guid result);
static member TryParse : ReadOnlySpan<char> * Guid -> bool
Public Shared Function TryParse (input As ReadOnlySpan(Of Char), ByRef result As Guid) As Boolean

매개 변수

input
ReadOnlySpan<Char>

변환할 GUID를 나타내는 문자를 포함하는 범위입니다.A span containing the characters representing the GUID to convert.

result
Guid

구문 분석된 값을 포함할 Guid 인스턴스입니다.A Guid instance to contain the parsed value. 메서드가 true를 반환하면 result에 유효한 Guid가 포함됩니다.If the method returns true, result contains a valid Guid. 메서드가 false를 반환하는 경우 resultEmpty와 같습니다.If the method returns false, result equals Empty.

반환

구문 분석 작업에 성공하면 true이고, 그렇지 않으면 false입니다.true if the parse operation was successful; otherwise, false.

TryParse(String, Guid)

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

public:
 static bool TryParse(System::String ^ input, [Runtime::InteropServices::Out] Guid % result);
public static bool TryParse (string input, out Guid result);
static member TryParse : string * Guid -> bool
Public Shared Function TryParse (input As String, ByRef result As Guid) As Boolean

매개 변수

input
String

변환할 GUID를 포함하는 문자열입니다.A string containing the GUID to convert.

result
Guid

구문 분석된 값을 포함할 Guid 인스턴스입니다.A Guid instance to contain the parsed value. 메서드가 true를 반환하면 result에 유효한 Guid가 포함됩니다.If the method returns true, result contains a valid Guid. 메서드가 false를 반환하는 경우 resultEmpty와 같습니다.If the method returns false, result equals Empty.

반환

구문 분석 작업에 성공하면 true이고, 그렇지 않으면 false입니다.true if the parse operation was successful; otherwise, false.

예제

다음 예제에서는 새 GUID를 만들고, "B", "D" 및 "X" 형식 지정자를 사용 하 여 ToString(String) 메서드를 호출한 다음 TryParse 메서드를 호출 하 여 문자열을 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 TryParse method to convert the strings back to Guid values.

Guid 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)
{
    if (Guid.TryParse(stringGuid, out var newGuid))
        Console.WriteLine($"Converted {stringGuid} to a Guid");
    else
        Console.WriteLine($"Unable to convert {stringGuid} to a Guid");
}

// 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.
      Dim newGuid As Guid
      For Each stringGuid In stringGuids
         If Guid.TryParse(stringGuid, newGuid) Then
            Console.WriteLine("Converted {0} to a Guid", stringGuid)
         Else
            Console.WriteLine("Unable to convert {0} to a Guid", 
                              stringGuid)
         End If     
      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 메서드와 유사 합니다. 단, 구문 분석 된 GUID를 반환 하는 대신 inputnull 되거나 인식 된 형식이 아닐 경우 false을 반환 하 고 예외를 throw 하지 않습니다.This method is like the Parse method, except that instead of returning the parsed GUID, it returns false if input is null or not in a recognized format, and doesn't throw an exception. 다음 표와 같이 input에서 선행 또는 후행 공백을 자르고 ToString(String)ToString(String, IFormatProvider) 메서드에서 인식 되는 5 가지 형식으로 문자열을 변환 합니다.It trims any leading or trailing white space from input and converts strings in any of the five formats recognized 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}}

추가 정보

적용 대상