Guid.TryParse Метод

Определение

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

System

Сборка:

System.Runtime.dll

Перегрузки

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

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.

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 значение , если input имеет null или нет распознанный формат, и не создает исключение. Он обрезает все начальные или конечные пробелы из 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)