Guid.Parse Méthode

Définition

Espace de noms:: System

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assemblys:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

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

Nom	Description
Parse(String, IFormatProvider)	Analyse une chaîne en une valeur.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Analyse une étendue de caractères en une valeur.
Parse(ReadOnlySpan<Byte>, IFormatProvider)	Analyse une étendue de caractères UTF-8 en une valeur.
Parse(ReadOnlySpan<Char>)	Convertit une étendue de caractères en lecture seule qui représente un GUID en structure équivalente Guid .
Parse(ReadOnlySpan<Byte>)
Parse(String)	Convertit la représentation sous forme de chaîne d’un GUID en structure équivalente Guid .

Parse(String, IFormatProvider)

Source:: Guid.cs

Source:: Guid.cs

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 spécifiques à la culture sur s.

Retours

Guid

Résultat de l’analyse s.

Implémente

Parse(String, IFormatProvider)

S’applique à

Parse(ReadOnlySpan<Char>, IFormatProvider)

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

Analyse une étendue de caractères en 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 de caractères à analyser.

provider: IFormatProvider

Objet qui fournit des informations de mise en forme spécifiques à la culture sur s.

Retours

Guid

Résultat de l’analyse s.

Implémente

Parse(ReadOnlySpan<Char>, IFormatProvider)

S’applique à

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Source:: Guid.cs

Source:: Guid.cs

Analyse une étendue de caractères UTF-8 en une valeur.

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

Paramètres

utf8Text: ReadOnlySpan<Byte>

Étendue de caractères UTF-8 à analyser.

provider: IFormatProvider

Objet qui fournit des informations de mise en forme spécifiques à la culture sur utf8Text.

Retours

Guid

Résultat de l’analyse utf8Text.

Implémente

Parse(ReadOnlySpan<Byte>, IFormatProvider)

S’applique à

Parse(ReadOnlySpan<Char>)

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

Convertit une étendue de caractères en lecture seule qui représente un GUID en structure équivalente 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

Paramètres

input: ReadOnlySpan<Char>

Étendue en lecture seule contenant les octets représentant un GUID.

Retours

Guid

Structure qui contient la valeur analysée.

Exceptions

FormatException

input n’est pas dans un format reconnu.

- ou -

Après le découpage, la longueur de l’étendue de caractères en lecture seule est 0.

Remarques

La Parse méthode supprime les espaces blancs de début ou de fin et input convertit les caractères restants dans input une 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, placés entre 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 entre accolades, où la quatrième valeur est un sous-ensemble de huit valeurs hexadécimales qui sont également placées entre accolades	{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

La méthode lève une FormatException valeur 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 de caractères 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(ReadOnlySpan<Byte>)

Source:: Guid.cs

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

Paramètres

utf8Text: ReadOnlySpan<Byte>

Retours

Guid

S’applique à

Parse(String)

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

Convertit la représentation sous forme de chaîne d’un GUID en structure équivalente 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

Paramètres

input: String

La chaîne à convertir.

Retours

Guid

Structure qui contient la valeur analysée.

Exceptions

ArgumentNullException

input a la valeur null.

FormatException

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 tout espace blanc de début ou de fin et convertit la représentation sous forme de input chaîne d’un Guid GUID en valeur. 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) les 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, placés entre 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 entre accolades, où la quatrième valeur est un sous-ensemble de huit valeurs hexadécimales qui sont également placées entre accolades	{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

La méthode lève une FormatException valeur 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 de caractères 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

Cette page a-t-elle été utile ?