Guid.Parse Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
Parse(String, IFormatProvider) |
Analyse une chaîne en une valeur. |
Parse(ReadOnlySpan<Char>, IFormatProvider) |
Analyse une étendue de caractères dans une valeur. |
Parse(ReadOnlySpan<Char>) |
Convertit une étendue de caractères en lecture seule qui représente un GUID en une structure Guid équivalente. |
Parse(String) |
Convertit la représentation sous forme de chaîne d'un GUID en une structure Guid équivalente. |
Parse(String, IFormatProvider)
- Source:
- Guid.cs
- Source:
- Guid.cs
- Source:
- Guid.cs
Analyse une chaîne en une valeur.
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
Paramètres
- s
- String
Chaîne à analyser.
- provider
- IFormatProvider
Objet qui fournit des informations de mise en forme propres à la culture concernant s
.
Retours
Résultat de l’analyse .s
Implémente
S’applique à
Parse(ReadOnlySpan<Char>, IFormatProvider)
- Source:
- Guid.cs
- Source:
- Guid.cs
- Source:
- Guid.cs
Analyse une étendue de caractères dans une valeur.
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
Paramètres
- s
- ReadOnlySpan<Char>
Étendue des caractères à analyser.
- provider
- IFormatProvider
Objet qui fournit des informations de mise en forme propres à la culture concernant s
.
Retours
Résultat de l’analyse .s
Implémente
S’applique à
Parse(ReadOnlySpan<Char>)
- Source:
- Guid.cs
- Source:
- Guid.cs
- Source:
- Guid.cs
Convertit une étendue de caractères en lecture seule qui représente un GUID en une structure Guid équivalente.
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
Paramètres
- input
- ReadOnlySpan<Char>
Étendue en lecture seule contenant les octets représentant un GUID.
Retours
Structure qui contient la valeur analysée.
Exceptions
input
n’est pas dans un format reconnu.
- ou -
Après la troncation, la longueur de l’étendue de caractères en lecture seule est 0.
Remarques
La Parse méthode supprime tous les espaces blancs de début ou de fin de input
et convertit les caractères restants dans une input
Guid valeur. Cette méthode peut convertir une étendue de caractères qui représente l’un des cinq formats produits par les ToString méthodes, comme indiqué dans le tableau suivant.
Spécificateur | Description | Format |
---|---|---|
N |
32 chiffres hexadécimaux | 00000000000000000000000000000000 |
D |
32 chiffres hexadécimaux séparés par des traits d’union | 00000000-0000-0000-0000-000000000000 |
B |
32 chiffres hexadécimaux séparés par des traits d’union, entourés d’accolades | {00000000-0000-0000-0000-000000000000} |
P |
32 chiffres hexadécimaux séparés par des traits d’union, placés entre parenthèses | (00000000-0000-0000-0000-000000000000) |
X |
Quatre valeurs hexadécimales placées dans des accolades, où la quatrième valeur est un sous-ensemble de huit valeurs hexadécimales également placées dans des accolades | {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}} |
La méthode lève un FormatException si elle ne parvient pas à analyser correctement la chaîne. Voici quelques-unes des raisons pour lesquelles cela peut se produire :
input
contient des caractères qui ne font pas partie du jeu de caractères hexadécimaux.input
a trop ou trop peu de caractères.input
n’est pas dans l’un des formats reconnus par la ToString méthode et répertoriés dans le tableau précédent.
Utilisez la TryParse méthode pour intercepter les opérations d’analyse infructueuses sans avoir à gérer une exception.
S’applique à
Parse(String)
- Source:
- Guid.cs
- Source:
- Guid.cs
- Source:
- Guid.cs
Convertit la représentation sous forme de chaîne d'un GUID en une structure Guid équivalente.
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
Paramètres
- input
- String
Chaîne à convertir.
Retours
Structure qui contient la valeur analysée.
Exceptions
input
a la valeur null
.
input
n’est pas dans un format reconnu.
Exemples
L’exemple suivant crée un GUID, le convertit en trois représentations de chaîne distinctes en appelant la ToString(String) méthode avec les spécificateurs de format « B », « D » et « X », puis appelle la Parse méthode pour convertir les chaînes en Guid valeurs.
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
Remarques
La Parse méthode supprime les espaces blancs de début ou de fin de input
et convertit la représentation sous forme de chaîne d’un GUID en valeur Guid . Cette méthode peut convertir des chaînes dans l’un des cinq formats produits par les ToString(String) méthodes et ToString(String, IFormatProvider) , comme indiqué dans le tableau suivant.
Spécificateur | Description | Format |
---|---|---|
N |
32 chiffres hexadécimaux | 00000000000000000000000000000000 |
D |
32 chiffres hexadécimaux séparés par des traits d’union | 00000000-0000-0000-0000-000000000000 |
B |
32 chiffres hexadécimaux séparés par des traits d’union, entourés d’accolades | {00000000-0000-0000-0000-000000000000} |
P |
32 chiffres hexadécimaux séparés par des traits d’union, placés entre parenthèses | (00000000-0000-0000-0000-000000000000) |
X |
Quatre valeurs hexadécimales placées dans des accolades, où la quatrième valeur est un sous-ensemble de huit valeurs hexadécimales également placées dans des accolades | {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}} |
La méthode lève un FormatException si elle ne parvient pas à analyser correctement la chaîne. Voici quelques-unes des raisons pour lesquelles cela peut se produire :
input
contient des caractères qui ne font pas partie du jeu de caractères hexadécimaux.input
a trop ou trop peu de caractères.input
n’est pas dans l’un des formats reconnus par la ToString méthode et répertoriés dans le tableau précédent.
Utilisez la TryParse méthode pour intercepter les opérations d’analyse infructueuses sans avoir à gérer une exception.
Voir aussi
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de l’année 2024, nous abandonnerons progressivement le mécanisme de retour d’information GitHub Issues pour le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez :Soumettre et afficher des commentaires pour