Guid.TryParse Метод

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Перегрузки

TryParse(ReadOnlySpan<Char>, Guid)	Преобразует указанный диапазон символов только для чтения, содержащий представление GUID в эквивалентную структуру Guid.
TryParse(String, Guid)	Преобразует строковое представление GUID в эквивалентную Guid структуру.
TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)	Пытается проанализировать диапазон символов в значение.
TryParse(String, IFormatProvider, Guid)	Пытается проанализировать строку в значение.

TryParse(ReadOnlySpan<Char>, Guid)

Исходный код:

Guid.cs

Преобразует указанный диапазон символов только для чтения, содержащий представление GUID в эквивалентную структуру Guid.

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 для преобразования.

result

Guid

При возврате этого метода содержит проанализированное значение. Если метод возвращает true, result содержит допустимый Guid. Если метод возвращает false, result равно Empty.

Возвращаемое значение

Boolean

true, если операция синтаксического анализа выполнена успешно; в противном случае false.

TryParse(String, Guid)

Исходный код:

Guid.cs

Преобразует строковое представление GUID в эквивалентную Guid структуру.

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 для преобразования.

result

Guid

При возврате этого метода содержит проанализированное значение. Если метод возвращает true, result содержит допустимый Guid. Если метод возвращает false, result равно Empty.

Возвращаемое значение

Boolean

true, если операция синтаксического анализа выполнена успешно; в противном случае false.

Примеры

В следующем примере создается новый GUID, он преобразуется в три отдельных строковых представления, вызывая метод ToString(String) с описателями формата B, D и X, а затем вызывает метод TryParse для преобразования строк обратно в Guid значения.

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

open System

let originalGuid = Guid.NewGuid()

// Create an array of string representations of the GUID.
let stringGuids =
    [| originalGuid.ToString "B"
       originalGuid.ToString "D"
       originalGuid.ToString "X" |]

// Parse each string representation.
for stringGuid in stringGuids do
    match Guid.TryParse stringGuid with
    | true, newGuid ->
        printfn $"Converted {stringGuid} to a Guid"
    | _ ->
        printfn $"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 он возвращает false, если inputnull или нет в распознаваемом формате и не создает исключение. Он обрезает любое начальное или конечное пробел от input и преобразует строки в любом из пяти форматов, распознаваемых ToString(String) и ToString(String, IFormatProvider) методами, как показано в следующей таблице.

Описатель	Описание	Формат
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	Четыре шестнадцатеричные значения, заключенные в скобки, где четвертое значение является подмножеством из восьми шестнадцатеричных значений, которые также заключены в скобки	{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00;0x00}}

См. также раздел

• Parse(String)

TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)

Исходный код:

Guid.cs

Пытается проанализировать диапазон символов в значение.

public:
 static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] Guid % result) = ISpanParsable<Guid>::TryParse;

public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out Guid result);

static member TryParse : ReadOnlySpan<char> * IFormatProvider * Guid -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As Guid) As Boolean

Параметры

s

ReadOnlySpan<Char>

Диапазон символов для синтаксического анализа.

provider

IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящее от языка и региональных параметров, о s.

result

Guid

При возврате этого метода содержит результат успешного анализа sили неопределенное значение при сбое.

Возвращаемое значение

Boolean

true, если s был успешно проанализирован; в противном случае false.

TryParse(String, IFormatProvider, Guid)

Исходный код:

Guid.cs

Пытается проанализировать строку в значение.

public:
 static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] Guid % result) = IParsable<Guid>::TryParse;

public static bool TryParse (string? s, IFormatProvider? provider, out Guid result);

static member TryParse : string * IFormatProvider * Guid -> bool

Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As Guid) As Boolean

Параметры

s

String

Строка для синтаксического анализа.

provider

IFormatProvider

Объект, предоставляющий сведения о форматировании, зависящее от языка и региональных параметров, о s.

result

Guid

Когда этот метод возвращается, содержит результат успешного анализа s или неопределенного значения при сбое.

Возвращаемое значение

Boolean

true, если s был успешно проанализирован; в противном случае false.