Guid.Parse 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
Parse(String, IFormatProvider)	Transforma uma cadeia num valor.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Divide um intervalo de caracteres num valor.
Parse(ReadOnlySpan<Byte>, IFormatProvider)	Analisa um intervalo de caracteres UTF-8 num valor.
Parse(ReadOnlySpan<Char>)	Converte um intervalo de caracteres somente de leitura que representa um GUID para a estrutura equivalente Guid .
Parse(ReadOnlySpan<Byte>)
Parse(String)	Converte a representação da cadeia de um GUID para a estrutura equivalente Guid .

Parse(String, IFormatProvider)

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

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

provider: IFormatProvider

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

Devoluções

Guid

O resultado da análise sintática s.

Implementações

Parse(String, IFormatProvider)

Aplica-se a

Parse(ReadOnlySpan<Char>, IFormatProvider)

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

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

provider: IFormatProvider

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

Devoluções

Guid

O resultado da análise sintática s.

Implementações

Parse(ReadOnlySpan<Char>, IFormatProvider)

Aplica-se a

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Origem:: Guid.cs

Origem:: Guid.cs

Analisa um intervalo de caracteres UTF-8 num valor.

public:
 static Guid Parse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider) = IUtf8SpanParsable<Guid>::Parse;

public static Guid Parse(ReadOnlySpan<byte> utf8Text, IFormatProvider? provider);

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

Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider) As Guid

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.

Devoluções

Guid

O resultado da análise sintática utf8Text.

Implementações

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Aplica-se a

Parse(ReadOnlySpan<Char>)

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

Origem:: Guid.cs

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

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 span de apenas leitura contendo os bytes que representam um GUID.

Devoluções

Guid

Uma estrutura que contém o valor que foi analisado.

Exceções

FormatException

input não está num formato reconhecido.

-ou-

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

Observações

O Parse método corta quaisquer caracteres de espaço em branco inicial ou final e input converte os caracteres restantes em input um Guid valor. Este método pode converter um espaço de caracteres que represente qualquer um dos cinco formatos produzidos pelos ToString métodos, como mostrado na tabela seguinte.

Especificador	Descrição	Formato
`N`	32 dígitos hexadecimais	00000000000000000000000000000000
`D`	32 dígitos hexadecimais separados por hífens	00000000-0000-0000-0000-000000000000
`B`	32 dígitos hexadecimais separados por hífens, encerrados em colchetes	{00000000-0000-0000-0000-000000000000}
`P`	32 dígitos hexadecimais 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}}

O método lança um FormatException se não conseguir analisar a cadeia com sucesso. Algumas das razões pelas quais isto pode acontecer incluem:

input contém caracteres que não fazem parte do conjunto hexadecimal.
input tem demasiadas ou poucas personagens.
input não está num dos formatos reconhecidos pelo ToString método e listados na tabela anterior.

Use o TryParse método para detetar operações de análise sintática sem sucesso sem ter de lidar com uma exceção.

Aplica-se a

Parse(ReadOnlySpan<Byte>)

Origem:: Guid.cs

Origem:: Guid.cs

public:
 static Guid Parse(ReadOnlySpan<System::Byte> utf8Text);

public static Guid Parse(ReadOnlySpan<byte> utf8Text);

static member Parse : ReadOnlySpan<byte> -> Guid

Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte)) As Guid

Parâmetros

utf8Text: ReadOnlySpan<Byte>

Devoluções

Guid

Aplica-se a

Parse(String)

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 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 a converter.

Devoluções

Guid

Uma estrutura que contém o valor que foi analisado.

Exceções

ArgumentNullException

input é null.

FormatException

input não está num formato reconhecido.

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 Parse método para converter as cadeias de volta a 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

Observações

O Parse método elimina qualquer espaço em branco inicial ou final e input converte a representação da cadeia de um GUID num Guid valor. Este método pode converter cadeias em qualquer um dos cinco formatos produzidos pelos ToString(String) métodos e, ToString(String, IFormatProvider) conforme mostrado na tabela seguinte.

Especificador	Descrição	Formato
`N`	32 dígitos hexadecimais	00000000000000000000000000000000
`D`	32 dígitos hexadecimais separados por hífens	00000000-0000-0000-0000-000000000000
`B`	32 dígitos hexadecimais separados por hífens, encerrados em colchetes	{00000000-0000-0000-0000-000000000000}
`P`	32 dígitos hexadecimais 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}}

O método lança um FormatException se não conseguir analisar a cadeia com sucesso. Algumas das razões pelas quais isto pode acontecer incluem:

input contém caracteres que não fazem parte do conjunto hexadecimal.
input tem demasiadas ou poucas personagens.
input não está num dos formatos reconhecidos pelo ToString método e listados na tabela anterior.

Use o TryParse método para detetar operações de análise sintática sem sucesso sem ter de lidar com uma exceção.

Ver também

Aplica-se a

Comentários

Esta página foi útil?