Guid.TryParse Метод

Определение

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

System

Сборки:

netstandard.dll, System.Runtime.dll

Перегрузки

Имя	Описание
TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)	Пытается проанализировать диапазон символов в значение.
TryParse(ReadOnlySpan<Byte>, Guid)
TryParse(ReadOnlySpan<Char>, Guid)	Преобразует указанный диапазон символов только для чтения, содержащий представление GUID в эквивалентную Guid структуру.
TryParse(String, Guid)	Преобразует строковое представление GUID в эквивалентную Guid структуру.
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Guid)	Пытается проанализировать диапазон символов UTF-8 в значение.
TryParse(String, IFormatProvider, 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(ReadOnlySpan<Byte>, Guid)

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

Guid.cs

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] Guid % result);

public static bool TryParse(ReadOnlySpan<byte> utf8Text, out Guid result);

static member TryParse : ReadOnlySpan<byte> * Guid -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As Guid) As Boolean

Параметры

utf8Text

ReadOnlySpan<Byte>

result

Guid

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

Boolean

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) методами, как показано в следующей таблице.

Спецификатор	Description	Формат
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<Byte>, IFormatProvider, Guid)

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

Guid.cs

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

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider, [Runtime::InteropServices::Out] Guid % result) = IUtf8SpanParsable<Guid>::TryParse;

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

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

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

Параметры

utf8Text

ReadOnlySpan<Byte>

Диапазон символов UTF-8 для анализа.

provider

IFormatProvider

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

result

Guid

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

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

Boolean

true Значение , если utf8Text был успешно проанализирован; в противном случае 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.