Guid.Parse Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Sobrecargas

Parse(String, IFormatProvider)	Analisa uma cadeia de caracteres em um valor .
Parse(ReadOnlySpan<Char>, IFormatProvider)	Analisa um intervalo de caracteres em um valor.
Parse(ReadOnlySpan<Char>)	Converte um intervalo de caracteres somente leitura que representa um GUID na estrutura Guid equivalente.
Parse(String)	Converte a representação de cadeia de caracteres de um GUID para a estrutura Guid equivalente.

Parse(String, IFormatProvider)

Origem:

Guid.cs

Analisa uma cadeia de caracteres em um valor .

public:
 static Guid Parse(System::String ^ s, IFormatProvider ^ provider) = IParsable<Guid>::Parse;

public static Guid Parse (string s, IFormatProvider? provider);

static member Parse : string * IFormatProvider -> Guid

Public Shared Function Parse (s As String, provider As IFormatProvider) As Guid

Parâmetros

s

String

A cadeia de caracteres a ser analisada.

provider

IFormatProvider

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

Retornos

Guid

O resultado da análise de s.

Implementações

Parse(String, IFormatProvider)

Parse(ReadOnlySpan<Char>, IFormatProvider)

Origem:

Guid.cs

Analisa um intervalo de caracteres em um valor.

public:
 static Guid Parse(ReadOnlySpan<char> s, IFormatProvider ^ provider) = ISpanParsable<Guid>::Parse;

public static Guid Parse (ReadOnlySpan<char> s, IFormatProvider? provider);

static member Parse : ReadOnlySpan<char> * IFormatProvider -> Guid

Public Shared Function Parse (s As ReadOnlySpan(Of Char), provider As IFormatProvider) As Guid

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 à cultura sobre s.

Retornos

Guid

O resultado da análise de s.

Implementações

Parse(ReadOnlySpan<Char>, IFormatProvider)

Parse(ReadOnlySpan<Char>)

Origem:

Guid.cs

Converte um intervalo de caracteres somente leitura que representa um GUID na estrutura Guid equivalente.

public:
 static Guid Parse(ReadOnlySpan<char> input);

public static Guid Parse (ReadOnlySpan<char> input);

static member Parse : ReadOnlySpan<char> -> Guid

Public Shared Function Parse (input As ReadOnlySpan(Of Char)) As Guid

Parâmetros

input

ReadOnlySpan<Char>

Um intervalo somente leitura que contém os bytes que representam um GUID.

Retornos

Guid

Uma estrutura que contém o valor analisado.

Exceções

FormatException

input não está em um formato reconhecido.

- ou -

Após o corte, o comprimento do intervalo de caracteres somente leitura é 0.

Comentários

O Parse método corta todos os caracteres de espaço em branco à esquerda ou à direita de input e converte os caracteres restantes em input em um Guid valor . Esse método pode converter um intervalo de caracteres que representa qualquer um dos cinco formatos produzidos pelos ToString métodos, conforme mostrado na tabela a seguir.

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

O método gerará um FormatException se não for possível analisar a cadeia de caracteres com êxito. Alguns dos motivos pelos quais isso pode ocorrer incluem:

• input contém caracteres que não fazem parte do conjunto de caracteres hexadecimal.

• input tem muitos ou poucos caracteres.

• input não está em um dos formatos reconhecidos pelo ToString método e listados na tabela anterior.

Use o TryParse método para capturar quaisquer operações de análise malsucedidas sem precisar lidar com uma exceção.

Parse(String)

Origem:

Guid.cs

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

public:
 static Guid Parse(System::String ^ input);

public static Guid Parse (string input);

static member Parse : string -> Guid

Public Shared Function Parse (input As String) As Guid

Parâmetros

input

String

A cadeia de caracteres a ser convertida.

Retornos

Guid

Uma estrutura que contém o valor analisado.

Exceções

ArgumentNullException

input é null.

FormatException

input não está em um formato reconhecido.

Exemplos

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

var 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)
{
    try
    {
        Guid newGuid = Guid.Parse(stringGuid);
        Console.WriteLine($"Converted {stringGuid} to a Guid");
    }
    catch (ArgumentNullException)
    {
        Console.WriteLine("The string to be parsed is null.");
    }
    catch (FormatException)
    {
        Console.WriteLine($"Bad format: {stringGuid}");
    }
}

// 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
    try
        let newGuid = Guid.Parse stringGuid
        printfn $"Converted {stringGuid} to a Guid"
    with
    | :? ArgumentNullException ->
        printfn "The string to be parsed is null."
    | :? FormatException ->
        printfn $"Bad format: {stringGuid}"

// 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.
      For Each stringGuid In stringGuids
         Try 
            Dim newGuid As Guid = Guid.Parse(stringGuid) 
            Console.WriteLine("Converted {0} to a Guid", stringGuid)
         Catch e As ArgumentNullException
            Console.WriteLine("The string to be parsed is null.")   
         Catch e As FormatException
            Console.WriteLine("Bad format: {0}", stringGuid)
         End Try     
      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

O Parse método corta qualquer espaço em branco à esquerda ou à direita de input e converte a representação de cadeia de caracteres de um GUID em um Guid valor. Esse método pode converter cadeias de caracteres em qualquer um dos cinco formatos produzidos pelos ToString(String) métodos e ToString(String, IFormatProvider) , conforme mostrado na tabela a seguir.

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

O método gerará um FormatException se não for possível analisar a cadeia de caracteres com êxito. Alguns dos motivos pelos quais isso pode ocorrer incluem:

• input contém caracteres que não fazem parte do conjunto de caracteres hexadecimal.

• input tem muitos ou poucos caracteres.

• input não está em um dos formatos reconhecidos pelo ToString método e listados na tabela anterior.

Use o TryParse método para capturar quaisquer operações de análise malsucedidas sem precisar lidar com uma exceção.

Confira também

• TryParse(String, Guid)
• ToString()