Compartilhar via


Guid.TryParse Método

Definição

Sobrecargas

TryParse(ReadOnlySpan<Char>, Guid)

Converte o intervalo de caracteres somente leitura especificado que contém a representação de um GUID para a estrutura de Guid equivalente.

TryParse(String, Guid)

Converte a representação de cadeia de caracteres de um GUID na estrutura de Guid equivalente.

TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)

Tenta analisar um intervalo de caracteres em um valor.

TryParse(String, IFormatProvider, Guid)

Tenta analisar uma cadeia de caracteres em um valor.

TryParse(ReadOnlySpan<Char>, Guid)

Origem:
Guid.cs
Origem:
Guid.cs
Origem:
Guid.cs

Converte o intervalo de caracteres somente leitura especificado que contém a representação de um GUID para a estrutura de Guid equivalente.

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

Parâmetros

input
ReadOnlySpan<Char>

Um intervalo que contém os caracteres que representam o GUID a ser convertido.

result
Guid

Quando esse método é retornado, contém o valor analisado. Se o método retornar true, result conterá um Guidválido. Se o método retornar false, result será igual a Empty.

Retornos

true se a operação de análise tiver sido bem-sucedida; caso contrário, false.

Aplica-se a

TryParse(String, Guid)

Origem:
Guid.cs
Origem:
Guid.cs
Origem:
Guid.cs

Converte a representação de cadeia de caracteres de um GUID na estrutura de Guid equivalente.

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

Parâmetros

input
String

Uma cadeia de caracteres que contém o GUID a ser convertido.

result
Guid

Quando esse método é retornado, contém o valor analisado. Se o método retornar true, result conterá um Guidválido. Se o método retornar false, result será igual a Empty.

Retornos

true se a operação de análise tiver sido bem-sucedida; caso contrário, false.

Exemplos

O exemplo a seguir cria um novo GUID, converte-o em três representações de cadeia de caracteres separadas chamando o método ToString(String) com os especificadores de formato "B", "D" e "X" e, em seguida, chama o método TryParse para converter as cadeias de caracteres de volta em valores 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

Comentários

Esse método é como o método Parse, exceto que, em vez de retornar o GUID analisado, ele retornará false se input estiver null ou não em um formato reconhecido e não gerar uma exceção. Ele corta qualquer espaço em branco à esquerda ou à direita de input e converte cadeias de caracteres em qualquer um dos cinco formatos reconhecidos pelos métodos ToString(String) e ToString(String, IFormatProvider), conforme mostrado na tabela a seguir.

Especificador Descrição Formato
N 32 dígitos 00000000000000000000000000000000
D 32 dígitos separados por hifens 00000000-0000-0000-0000-000000000000
B 32 dígitos separados por hifens, entre chaves {00000000-0000-0000-0000-000000000000}
P 32 dígitos separados por hifens, entre parênteses (00000000-0000-0000-0000-000000000000)
X Quatro valores hexadecimal entre chaves, em que o quarto valor é um subconjunto de oito valores hexadecimal que também está entre chaves {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Confira também

Aplica-se a

TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)

Origem:
Guid.cs
Origem:
Guid.cs
Origem:
Guid.cs

Tenta analisar um intervalo de caracteres em um valor.

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

Parâmetros

s
ReadOnlySpan<Char>

O intervalo de caracteres a serem analisados.

provider
IFormatProvider

Um objeto que fornece informações de formatação específicas da cultura sobre s.

result
Guid

Quando esse método é retornado, contém o resultado da análise bem-sucedida de sou um valor indefinido sobre a falha.

Retornos

true se s foi analisado com êxito; caso contrário, false.

Aplica-se a

TryParse(String, IFormatProvider, Guid)

Origem:
Guid.cs
Origem:
Guid.cs
Origem:
Guid.cs

Tenta analisar uma cadeia de caracteres em um valor.

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

Parâmetros

s
String

A cadeia de caracteres a ser analisada.

provider
IFormatProvider

Um objeto que fornece informações de formatação específicas da cultura sobre s.

result
Guid

Quando esse método é retornado, contém o resultado da análise bem-sucedida de s ou de um valor indefinido sobre a falha.

Retornos

true se s foi analisado com êxito; caso contrário, false.

Aplica-se a