Guid.TryParse Método

Definição

Espaço de Nomes:: System

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: netstandard.dll

Assemblagens:: mscorlib.dll, System.Runtime.dll

Assemblagem:: mscorlib.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Sobrecargas

Name	Description
TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)	Tenta separar um intervalo de caracteres num valor.
TryParse(ReadOnlySpan<Byte>, Guid)
TryParse(ReadOnlySpan<Char>, Guid)	Converte o espaço especificado de apenas leitura dos caracteres contendo a representação de um GUID para a estrutura equivalente Guid .
TryParse(String, Guid)	Converte a representação da cadeia de um GUID para a estrutura equivalente Guid .
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Guid)	Tenta separar um intervalo de caracteres UTF-8 num valor.
TryParse(String, IFormatProvider, Guid)	Tenta analisar uma cadeia num valor.

TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Tenta separar um intervalo de caracteres num 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 número de personagens a analisar.

provider: IFormatProvider

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

result: Guid

Quando este método retorna, contém o resultado de uma sanálise bem-sucedida , ou um valor indefinido em caso de falha.

Devoluções

Boolean

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

Aplica-se a

TryParse(ReadOnlySpan<Byte>, Guid)

Origem:: Guid.cs

Origem:: 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

Parâmetros

utf8Text: ReadOnlySpan<Byte>

result: Guid

Devoluções

Boolean

Aplica-se a

TryParse(ReadOnlySpan<Char>, Guid)

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Converte o espaço especificado de apenas leitura dos caracteres contendo a representação de um GUID para a estrutura equivalente 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

Parâmetros

input: ReadOnlySpan<Char>

Um espaço que contém os caracteres que representam o GUID a converter.

result: Guid

Quando este método retorna, contém o valor analisado. Se o método devolver true, result contém um válido Guid. Se o método devolver false, result é Emptyigual a .

Devoluções

Boolean

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

Aplica-se a

TryParse(String, Guid)

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Converte a representação da cadeia de um GUID para a estrutura equivalente 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

Parâmetros

input: String

Uma cadeia contendo o GUID a converter.

result: Guid

Quando este método retorna, contém o valor analisado. Se o método devolver true, result contém um válido Guid. Se o método devolver false, result é Emptyigual a .

Devoluções

Boolean

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

Exemplos

O exemplo seguinte cria um novo GUID, converte-o para três representações de cadeias separadas chamando o ToString(String) método com os especificadores de formato "B", "D" e "X", e depois chama o TryParse método para converter as cadeias de volta a Guid valores.

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

Observações

Este método é semelhante ao Parse método, exceto que, em vez de devolver o GUID analisado, devolve false se input está null ou não num formato reconhecido, e não lança nenhuma exceção. Corta qualquer espaço em branco inicial ou final e input converte cadeias em qualquer um dos cinco formatos reconhecidos pelos ToString(String) métodos e, ToString(String, IFormatProvider) conforme mostrado na tabela seguinte.

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

Ver também

Parse(String)

Aplica-se a

TryParse(ReadOnlySpan<Byte>, IFormatProvider, Guid)

Origem:: Guid.cs

Origem:: Guid.cs

Tenta separar um intervalo de caracteres UTF-8 num valor.

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

Parâmetros

utf8Text: ReadOnlySpan<Byte>

A extensão de caracteres UTF-8 para analisar.

provider: IFormatProvider

Um objeto que fornece informação de formatação específica da cultura sobre utf8Text.

result: Guid

No retorno, contém o resultado de uma análise utf8Text bem-sucedida ou um valor indefinido em caso de falha.

Devoluções

Boolean

true se utf8Text foi analisado com sucesso; caso contrário, false.

Aplica-se a

TryParse(String, IFormatProvider, Guid)

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Tenta analisar uma cadeia num 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 sequência a analisar.

provider: IFormatProvider

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

result: Guid

Quando este método retorna, contém o resultado de uma s análise bem-sucedida ou um valor indefinido em caso de falha.

Devoluções

Boolean

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

Aplica-se a

Comentários

Esta página foi útil?