Guid.TryParse Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Surcharges

TryParse(ReadOnlySpan<Char>, Guid)	Convertit l’étendue de caractères en lecture seule spécifiée contenant la représentation d’un GUID en structure Guid équivalente.
TryParse(String, Guid)	Convertit la représentation sous forme de chaîne d’un GUID en structure Guid équivalente.
TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)	Tente d’analyser une étendue de caractères en une valeur.
TryParse(String, IFormatProvider, Guid)	Tente d’analyser une chaîne en une valeur.

TryParse(ReadOnlySpan<Char>, Guid)

Source:

Guid.cs

Convertit l’étendue de caractères en lecture seule spécifiée contenant la représentation d’un GUID en structure Guid équivalente.

public:
 static bool TryParse(ReadOnlySpan<char> input, [Runtime::InteropServices::Out] Guid % result);

public static bool TryParse (ReadOnlySpan<char> input, out Guid result);

static member TryParse : ReadOnlySpan<char> * Guid -> bool

Public Shared Function TryParse (input As ReadOnlySpan(Of Char), ByRef result As Guid) As Boolean

Paramètres

input

ReadOnlySpan<Char>

Étendue contenant les caractères représentant le GUID à convertir.

result

Guid

Lorsque cette méthode est retournée, contient la valeur analysée. Si la méthode retourne true, result contient une Guidvalide. Si la méthode retourne false, result est égal à Empty.

Retours

Boolean

true si l’opération d’analyse a réussi ; sinon, false.

TryParse(String, Guid)

Source:

Guid.cs

Convertit la représentation sous forme de chaîne d’un GUID en structure Guid équivalente.

public:
 static bool TryParse(System::String ^ input, [Runtime::InteropServices::Out] Guid % result);

public static bool TryParse (string? input, out Guid result);

static member TryParse : string * Guid -> bool

Public Shared Function TryParse (input As String, ByRef result As Guid) As Boolean

Paramètres

input

String

Chaîne contenant le GUID à convertir.

result

Guid

Lorsque cette méthode est retournée, contient la valeur analysée. Si la méthode retourne true, result contient une Guidvalide. Si la méthode retourne false, result est égal à Empty.

Retours

Boolean

true si l’opération d’analyse a réussi ; sinon, false.

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 TryParse pour convertir les chaînes en valeurs Guid.

Guid 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)
{
    if (Guid.TryParse(stringGuid, out var newGuid))
        Console.WriteLine($"Converted {stringGuid} to a Guid");
    else
        Console.WriteLine($"Unable to convert {stringGuid} to a Guid");
}

// 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
    match Guid.TryParse stringGuid with
    | true, newGuid ->
        printfn $"Converted {stringGuid} to a Guid"
    | _ ->
        printfn $"Unable to convert {stringGuid} to a Guid"

// 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.
      Dim newGuid As Guid
      For Each stringGuid In stringGuids
         If Guid.TryParse(stringGuid, newGuid) Then
            Console.WriteLine("Converted {0} to a Guid", stringGuid)
         Else
            Console.WriteLine("Unable to convert {0} to a Guid", 
                              stringGuid)
         End If     
      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

Cette méthode est semblable à la méthode Parse, sauf qu’au lieu de renvoyer le GUID analysé, elle retourne false si input est null ou non dans un format reconnu et ne lève pas d’exception. Il supprime tout espace blanc de début ou de fin de input et convertit les chaînes dans l’un des cinq formats reconnus par les méthodes ToString(String) et ToString(String, IFormatProvider), comme indiqué dans le tableau suivant.

Spécificateur	Description	Format
N	32 chiffres	00000000000000000000000000000000
D	32 chiffres séparés par des traits d’union	00000000-0000-0000-0000-000000000000
B	32 chiffres séparés par des traits d’union, placés entre accolades	{00000000-0000-0000-0000-000000000000}
P	32 chiffres 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}}

Voir aussi

• Parse(String)

TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)

Source:

Guid.cs

Tente d’analyser une étendue de caractères en une valeur.

public:
 static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] Guid % result) = ISpanParsable<Guid>::TryParse;

public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out Guid result);

static member TryParse : ReadOnlySpan<char> * IFormatProvider * Guid -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As Guid) As Boolean

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.

result

Guid

Lorsque cette méthode est retournée, contient le résultat de l’analyse réussie de s, ou d’une valeur non définie en cas d’échec.

Retours

Boolean

true si s a été analysé avec succès ; sinon, false.

TryParse(String, IFormatProvider, Guid)

Source:

Guid.cs

Tente d’analyser une chaîne en une valeur.

public:
 static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] Guid % result) = IParsable<Guid>::TryParse;

public static bool TryParse (string? s, IFormatProvider? provider, out Guid result);

static member TryParse : string * IFormatProvider * Guid -> bool

Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As Guid) As Boolean

Paramètres

s

String

Chaîne à analyser.

provider

IFormatProvider

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

result

Guid

Lorsque cette méthode est retournée, contient le résultat de l’analyse réussie de s ou d’une valeur non définie en cas d’échec.

Retours

Boolean

true si s a été analysé avec succès ; sinon, false.