Guid.ToString Méthode

Définition

Retourne une chaîne représentant la valeur de cette instance de la structure Guid.Returns a string representation of the value of this instance of the Guid structure.

Surcharges

ToString()

Retourne une représentation sous forme de chaîne de la valeur de cette instance au format du Registre.Returns a string representation of the value of this instance in registry format.

ToString(String)

Retourne une représentation sous forme de chaîne de la valeur de cette instance Guid, selon le spécificateur de format fourni.Returns a string representation of the value of this Guid instance, according to the provided format specifier.

ToString(String, IFormatProvider)

Retourne une représentation sous forme de chaîne de la valeur de cette instance de la classe Guid, selon le spécificateur de format et les informations de format propres à la culture fournis.Returns a string representation of the value of this instance of the Guid class, according to the provided format specifier and culture-specific format information.

ToString()

Retourne une représentation sous forme de chaîne de la valeur de cette instance au format du Registre.Returns a string representation of the value of this instance in registry format.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Retours

Valeur de ce Guid, mise en forme à l'aide du spécificateur de format « D » comme suit :The value of this Guid, formatted by using the "D" format specifier as follows: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

où la valeur du GUID est représentée sous la forme d'une série de chiffres hexadécimaux en minuscules par groupes de 8, 4, 4, 4 et 12 chiffres et séparés par des traits d'union.where the value of the GUID is represented as a series of lowercase hexadecimal digits in groups of 8, 4, 4, 4, and 12 digits and separated by hyphens. Exemple de valeur de retour : « 382c74c3-721d-4f34-80e5-57657b6cbc27 ».An example of a return value is "382c74c3-721d-4f34-80e5-57657b6cbc27". Pour convertir les chiffres hexadécimaux de a à f en majuscules, appelez la méthode ToUpper() sur la chaîne retournée.To convert the hexadecimal digits from a through f to uppercase, call the ToUpper() method on the returned string.

Remarques

Cette méthode fournit un format GUID par défaut qui est suffisant pour une utilisation classique ; Toutefois, d’autres versions de cette méthode qui acceptent un paramètre format fournissent quelques variantes de format courantes.This method provides a default GUID format that is sufficient for typical use; however, other versions of this method that take a format parameter provide a few common format variations.

ToString(String)

Retourne une représentation sous forme de chaîne de la valeur de cette instance Guid, selon le spécificateur de format fourni.Returns a string representation of the value of this Guid instance, according to the provided format specifier.

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 ce Guid.A single format specifier that indicates how to format the value of this Guid. Le paramètre format peut être "N", "D", "B", "P" ou "X".The format parameter can be "N", "D", "B", "P", or "X". Si format a la valeur null ou une chaîne vide (""), "D" est utilisé.If format is null or an empty string (""), "D" is used.

Retours

Valeur de ce Guid, représentée sous la forme d’une série de chiffres hexadécimaux en minuscules dans le format spécifié.The value of this Guid, represented as a series of lowercase hexadecimal digits in the specified format.

Exceptions

La valeur de format n’est pas null, une chaîne vide (""), "N", "D", "B", "P" ni "X".The value of format is not null, an empty string (""), "N", "D", "B", "P", or "X".

Remarques

Le tableau suivant indique les spécificateurs de format acceptés pour le paramètre format.The following table shows the accepted format specifiers for the format parameter. « 0 » représente un chiffre ; les traits d’Union (« - »), les accolades (« { », « } ») et les parenthèses (« ( », « ) ») apparaissent comme indiqué."0" represents a digit; hyphens ("-"), braces ("{", "}"), and parentheses ("(", ")") appear as shown.

SpécificateurSpecifier Format de valeur de retourFormat of return value
N 32 chiffres :32 digits:

0000000000000000000000000000000000000000000000000000000000000000
D 32 chiffres séparés par des traits d’Union :32 digits separated by hyphens:

00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 32 chiffres séparés par des traits d’Union, entre accolades :32 digits separated by hyphens, enclosed in braces:

{00000000-0000-0000-0000-000000000000}
P 32 chiffres séparés par des traits d’Union, entre parenthèses :32 digits separated by hyphens, enclosed in parentheses:

(00000000-0000-0000-0000-000000000000)(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 est également placée entre accolades :Four hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces:

{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}{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.The hexadecimal digits a through f are lowercase in the returned string. Pour les convertir en majuscules, appelez la méthode String.ToUpper sur la chaîne retournée.To convert them to uppercase, call the String.ToUpper method on the returned string.

ToString(String, IFormatProvider)

Retourne une représentation sous forme de chaîne de la valeur de cette instance de la classe Guid, selon le spécificateur de format et les informations de format propres à la culture fournis.Returns a string representation of the value of this instance of the Guid class, according to the provided format specifier and culture-specific format information.

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 ce Guid.A single format specifier that indicates how to format the value of this Guid. Le paramètre format peut être "N", "D", "B", "P" ou "X".The format parameter can be "N", "D", "B", "P", or "X". Si format a la valeur null ou une chaîne vide (""), "D" est utilisé.If format is null or an empty string (""), "D" is used.

provider
IFormatProvider

(Réservé) Objet fournissant des informations de mise en forme propres à la culture.(Reserved) An object that supplies culture-specific formatting information.

Retours

Valeur de ce Guid, représentée sous la forme d’une série de chiffres hexadécimaux en minuscules dans le format spécifié.The value of this Guid, represented as a series of lowercase hexadecimal digits in the specified format.

Implémente

Exceptions

La valeur de format n’est pas null, une chaîne vide (""), "N", "D", "B", "P" ni "X".The value of format is not null, an empty string (""), "N", "D", "B", "P", or "X".

Remarques

Le paramètre provider est réservé pour une utilisation ultérieure et ne contribue pas à l’exécution de cette méthode.The provider parameter is reserved for future use and does not contribute to the execution of this method. Vous pouvez passer null dans l’appel de méthode.You can pass null in the method call.

Le tableau suivant indique les spécificateurs de format acceptés pour le paramètre format.The following table shows the accepted format specifiers for the format parameter. « 0 » représente un chiffre ; les traits d’Union (« - »), les accolades (« { », « } ») et les parenthèses (« ( », « ) ») apparaissent comme indiqué."0" represents a digit; hyphens ("-"), braces ("{", "}"), and parentheses ("(", ")") appear as shown.

SpécificateurSpecifier Format de valeur de retourFormat of return value
N 32 chiffres :32 digits:

0000000000000000000000000000000000000000000000000000000000000000
D 32 chiffres séparés par des traits d’Union :32 digits separated by hyphens:

00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 32 chiffres séparés par des traits d’Union, entre accolades :32 digits separated by hyphens, enclosed in braces:

{00000000-0000-0000-0000-000000000000}
P 32 chiffres séparés par des traits d’Union, entre parenthèses :32 digits separated by hyphens, enclosed in parentheses:

(00000000-0000-0000-0000-000000000000)(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 est également placée entre accolades :Four hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces:

{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}{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.The hexadecimal digits a through f are lowercase in the returned string. Pour les convertir en majuscules, appelez la méthode String.ToUpper sur la chaîne retournée.To convert them to uppercase, call the String.ToUpper method on the returned string.

É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.Because the provider parameter is ignored, you cannot use it to provide a custom formatting solution. 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 à la fois les interfaces ICustomFormatter et IFormatProvider.To represent a Guid value as a string in a format that isn't supported by the standard GUID format strings, call the String.Format(IFormatProvider, String, Object[]) method with a provider object that implements both the ICustomFormatter and IFormatProvider interfaces. Pour plus d’informations, consultez la section « mise en forme personnalisée avec ICustomFormatter » dans l’article sur les types de mise en forme .For more information, see the "Custom Formatting with ICustomFormatter" section in the Formatting Types article.

S’applique à