Lire en anglais

Partager via


Guid.TryParseExact Méthode

Définition

Surcharges

TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Guid)

Convertit l’étendue de caractères représentant le GUID en la structure Guid équivalente, à condition que la chaîne soit au format spécifié.

TryParseExact(String, String, Guid)

Convertit la représentation sous forme de chaîne d'un GUID en une structure Guid équivalente, à condition que la chaîne soit au format spécifié.

TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Guid)

Source:
Guid.cs
Source:
Guid.cs
Source:
Guid.cs

Convertit l’étendue de caractères représentant le GUID en la structure Guid équivalente, à condition que la chaîne soit au format spécifié.

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

Paramètres

input
ReadOnlySpan<Char>

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

format
ReadOnlySpan<Char>

Étendue en lecture seule contenant un caractère représentant l’un des spécificateurs suivants qui indique le format exact à utiliser pendant l'interprétation d’input : "N", "D", "B", "P" ou "X".

result
Guid

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

Retours

true si l'opération d'analyse réussit ; sinon, false.

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

TryParseExact(String, String, Guid)

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, à condition que la chaîne soit au format spécifié.

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

Paramètres

input
String

GUID à convertir.

format
String

Un des spécificateurs suivants qui indique le format exact à utiliser lors de l'interprétation de input : "N", "D", "B", "P" ou "X".

result
Guid

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

Retours

true si l'opération d'analyse réussit ; sinon, false.

Exemples

L’exemple suivant appelle la ToString(String) méthode avec chacun des spécificateurs de format pris en charge pour générer un tableau de chaînes qui représentent un GUID unique. Celles-ci sont ensuite transmises à la TryParseExact méthode, qui analyse correctement la chaîne conforme au spécificateur de format « B ».

// Define an array of all format specifiers.
string[] formats = { "N", "D", "B", "P", "X" };
Guid guid = Guid.NewGuid();
// Create an array of valid Guid string representations.
var stringGuids = new string[formats.Length];
for (int ctr = 0; ctr < formats.Length; ctr++)
    stringGuids[ctr] = guid.ToString(formats[ctr]);

// Parse the strings in the array using the "B" format specifier.
foreach (var stringGuid in stringGuids)
{
    if (Guid.TryParseExact(stringGuid, "B", out var newGuid))
        Console.WriteLine($"Successfully parsed {stringGuid}");
    else
        Console.WriteLine($"Unable to parse '{stringGuid}'");
}

// The example displays output similar to the following:
//
//    Unable to parse 'c0fb150f6bf344df984a3a0611ae5e4a'
//    Unable to parse 'c0fb150f-6bf3-44df-984a-3a0611ae5e4a'
//    Successfully parsed {c0fb150f-6bf3-44df-984a-3a0611ae5e4a}
//    Unable to parse '(c0fb150f-6bf3-44df-984a-3a0611ae5e4a)'
//    Unable to parse '{0xc0fb150f,0x6bf3,0x44df,{0x98,0x4a,0x3a,0x06,0x11,0xae,0x5e,0x4a}}'

Remarques

Cette méthode nécessite que la chaîne à convertir soit exactement au format spécifié par le paramètre, une fois que les format espaces blancs de début et de fin ont été supprimés. Elle retourne false si input est null ou n’est pas au format spécifié par format, et ne lève pas d’exception.

Le tableau suivant montre les spécificateurs de format acceptés pour le format paramètre. « 0 » représente un chiffre; Les traits d’union (« - »), les accolades (« { », « } ») et les parenthèses (« ( » , ») apparaissent comme indiqué.

Spécificateur Format du input paramètre
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 dans des 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 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}}

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0