Guid.Parse Méthode

Source:

Guid.cs

Source:

Guid.cs

Source:

Guid.cs

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

Retours

Résultat de l’analyse s.

Implémente

Source:

Guid.cs

Source:

Guid.cs

Source:

Guid.cs

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

Retours

Résultat de l’analyse s.

Implémente

Source:

Guid.cs

Source:

Guid.cs

Source:

Guid.cs

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

Retours

Structure qui contient la valeur analysée.

Exceptions

Exemples

L’exemple suivant crée un GUID, le convertit en trois représentations de chaîne distinctes en appelant la méthode ToString(String) avec les spécificateurs de format « B », « D » et « X », puis appelle la méthode Parse pour convertir les chaînes en valeurs Guid.

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 méthode Parse supprime tout espace blanc 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 méthodes ToString(String) et ToString(String, IFormatProvider), comme indiqué dans le tableau suivant.

La méthode lève une 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 de caractères ou trop peu de caractères.

• input n’est pas dans l’un des formats reconnus par la méthode ToString et répertoriés dans le tableau précédent.

Utilisez la méthode TryParse pour intercepter les opérations d’analyse infructueuses sans avoir à gérer une exception.

Voir aussi

• TryParse(String, Guid)
• ToString()

Source:

Guid.cs

Source:

Guid.cs

Source:

Guid.cs

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

Retours

Structure qui contient la valeur analysée.

Exceptions

Remarques

La méthode Parse supprime les espaces blancs de début ou de fin de input et convertit les caractères restants dans input en valeur de Guid. Cette méthode peut convertir une étendue de caractères qui représente l’un des cinq formats produits par les méthodes ToString, comme indiqué dans le tableau suivant.

La méthode lève une 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 de caractères ou trop peu de caractères.

• input n’est pas dans l’un des formats reconnus par la méthode ToString et répertoriés dans le tableau précédent.

Utilisez la méthode TryParse pour intercepter les opérations d’analyse infructueuses sans avoir à gérer une exception.