Guid.ToString Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Retourne une représentation sous forme de chaîne de la valeur de cette instance de la structure Guid.

Surcharges

ToString(String)	Retourne une représentation sous forme de chaîne de la valeur de cette instance Guid, en fonction du spécificateur de format fourni.
ToString()	Retourne une représentation sous forme de chaîne de la valeur de cette instance au format de Registre.
ToString(String, IFormatProvider)	Retourne une représentation sous forme de chaîne de la valeur de cette instance de la classe Guid, en fonction des informations de format fournies du spécificateur de format et des informations de format propres à la culture.

ToString(String)

Source:

Guid.cs

Retourne une représentation sous forme de chaîne de la valeur de cette instance Guid, en fonction du spécificateur de format fourni.

public:
 System::String ^ ToString(System::String ^ format);

public string ToString (string? format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

Paramètres

format

String

Spécificateur de format unique qui indique comment mettre en forme la valeur de cette Guid. Le paramètre format peut être « N », « D », « B », « P » ou « X ». Si format est null ou une chaîne vide («  »), « D » est utilisé.

Retours

String

Valeur de cette Guid, représentée sous la forme d’une série de chiffres hexadécimaux minuscules au format spécifié.

Exceptions

FormatException

La valeur de format n’est pas null, une chaîne vide («  »), « N », « D », « B », « P » ou « X ».

Remarques

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

Spécificateur	Format de la valeur de retour
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}}

Les chiffres hexadécimaux a f sont en minuscules dans la chaîne retournée. Pour les convertir en majuscules, appelez la méthode String.ToUpper sur la chaîne retournée.

ToString()

Source:

Guid.cs

Retourne une représentation sous forme de chaîne de la valeur de cette instance au format de Registre.

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Retours

String

Valeur de cette Guid, mise en forme à l’aide du spécificateur de format « D » comme suit :

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

où la valeur du GUID est représentée sous la forme d’une série de chiffres hexadécimaux minuscules dans des groupes de 8, 4, 4, 4 et 4 et 12 chiffres et séparés par des traits d’union. Un exemple de valeur de retour est « 382c74c3-721d-4f34-80e5-57657b6cbc27 ». Pour convertir les chiffres hexadécimaux d’un à f en majuscules, appelez la méthode ToUpper() sur la chaîne retournée.

Remarques

Cette méthode fournit un format GUID par défaut suffisant pour une utilisation classique ; Toutefois, d’autres versions de cette méthode qui prennent un paramètre format fournissent quelques variantes de format courantes.

ToString(String, IFormatProvider)

Source:

Guid.cs

Retourne une représentation sous forme de chaîne de la valeur de cette instance de la classe Guid, en fonction des informations de format fournies du spécificateur de format et des informations de format propres à la culture.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);

public string ToString (string? format, IFormatProvider? provider);

override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, provider As IFormatProvider) As String

Paramètres

format

String

Spécificateur de format unique qui indique comment mettre en forme la valeur de cette Guid. Le paramètre format peut être « N », « D », « B », « P » ou « X ». Si format est null ou une chaîne vide («  »), « D » est utilisé.

provider

IFormatProvider

(Réservé) Objet qui fournit des informations de mise en forme propres à la culture.

Retours

String

Valeur de cette Guid, représentée sous la forme d’une série de chiffres hexadécimaux minuscules au format spécifié.

Implémente

ToString(String, IFormatProvider)

Exceptions

FormatException

La valeur de format n’est pas null, une chaîne vide («  »), « N », « D », « B », « P » ou « X ».

Remarques

Le paramètre provider est réservé à une utilisation ultérieure et ne contribue pas à l’exécution de cette méthode. Vous pouvez passer null dans l’appel de méthode.

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

Spécificateur	Format de la valeur de retour
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}}

Les chiffres hexadécimaux a f sont en minuscules dans la chaîne retournée. Pour les convertir en majuscules, appelez la méthode String.ToUpper sur la chaîne retournée.

Étant donné que le paramètre provider est ignoré, vous ne pouvez pas l’utiliser pour fournir une solution de mise en forme personnalisée. Pour représenter une valeur Guid sous forme de chaîne dans un format qui n’est pas pris en charge par les chaînes de format GUID standard, appelez la méthode String.Format(IFormatProvider, String, Object[]) avec un objet provider qui implémente les interfaces ICustomFormatter et IFormatProvider. Pour plus d’informations, consultez la section « Mise en forme personnalisée avec ICustomFormatter » dans l’article Types de mise en forme.