Guid.Parse Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- Origem:
- Guid.cs
- 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
O resultado da análise de s
.
Implementações
Aplica-se a
Parse(ReadOnlySpan<Char>, IFormatProvider)
- Origem:
- Guid.cs
- Origem:
- Guid.cs
- 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
O resultado da análise de s
.
Implementações
Aplica-se a
Parse(ReadOnlySpan<Char>)
- Origem:
- Guid.cs
- Origem:
- Guid.cs
- 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
Uma estrutura que contém o valor analisado.
Exceções
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.
Aplica-se a
Parse(String)
- Origem:
- Guid.cs
- Origem:
- Guid.cs
- 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
Uma estrutura que contém o valor analisado.
Exceções
input
é null
.
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
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários