Guid.TryParse Метод

Определение

Перегрузки

TryParse(String, IFormatProvider, Guid)

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

TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)

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

TryParse(ReadOnlySpan<Char>, Guid)

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

TryParse(String, Guid)

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

TryParse(String, IFormatProvider, Guid)

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

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
result
Guid

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

Boolean

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

Применяется к

TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)

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

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

Параметры

provider
IFormatProvider
result
Guid

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

Boolean

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

Применяется к

TryParse(ReadOnlySpan<Char>, Guid)

Преобразует указанный диапазон символов только для чтения, содержащий представление 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 в эквивалентную структуру Guid.

public:
 static bool TryParse(System::String ^ input, [Runtime::InteropServices::Out] Guid % result);
public static bool TryParse (string input, 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}}

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

Применяется к