Guid.ToString Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne une chaîne représentant la valeur de cette instance de la structure Guid.
Surcharges
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. |
ToString() |
Retourne une représentation sous forme de chaîne de la valeur de cette instance au format du Registre. |
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. |
ToString(String, IFormatProvider)
- Source:
- Guid.cs
- Source:
- Guid.cs
- Source:
- Guid.cs
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.
public:
virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (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. Le paramètre format
peut être "N", "D", "B", "P" ou "X". Si format
a la valeur null
ou une chaîne vide (""), "D" est utilisé.
- provider
- IFormatProvider
(Réservé) Objet fournissant des informations de mise en forme propres à la culture.
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é.
Implémente
Exceptions
La valeur de format
n’est pas null
, une chaîne vide (""), "N", "D", "B", "P" ni "X".
Remarques
Le provider
paramètre est réservé à une utilisation ultérieure et ne contribue pas à l’exécution de cette méthode. Vous pouvez passer null
l’appel de méthode.
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 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 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}} |
Les chiffres hexadécimaux a à f sont minuscules dans la chaîne retournée. Pour les convertir en majuscules, appelez la String.ToUpper méthode sur la chaîne retournée.
Étant donné que le provider
paramètre est ignoré, vous ne pouvez pas l’utiliser pour fournir une solution de mise en forme personnalisée. Pour représenter une Guid valeur sous la forme d’une chaîne dans un format qui n’est pas pris en charge par les chaînes de format GUID standard, appelez la String.Format(IFormatProvider, String, Object[]) méthode avec un provider
objet qui implémente à la fois les ICustomFormatter interfaces et IFormatProvider . Pour plus d’informations, consultez la section « Mise en forme personnalisée avec ICustomFormatter » dans l’article Types de mise en forme .
S’applique à
ToString()
- Source:
- Guid.cs
- Source:
- Guid.cs
- Source:
- Guid.cs
Retourne une représentation sous forme de chaîne de la valeur de cette instance au format du Registre.
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 :
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 en minuscules par groupes de 8, 4, 4, 4 et 12 chiffres et séparés par des traits d'union. Exemple de valeur de retour : « 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.
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 format
paramètre fournissent quelques variantes de format courantes.
S’applique à
ToString(String)
- Source:
- Guid.cs
- Source:
- Guid.cs
- Source:
- Guid.cs
Retourne une représentation sous forme de chaîne de la valeur de cette instance Guid, selon le spécificateur de format fourni.
public:
System::String ^ ToString(System::String ^ format);
public string ToString (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. Le paramètre format
peut être "N", "D", "B", "P" ou "X". Si format
a la valeur null
ou une chaîne vide (""), "D" est utilisé.
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é.
Exceptions
La valeur de format
n’est pas null
, une chaîne vide (""), "N", "D", "B", "P" ni "X".
Remarques
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 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 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}} |
Les chiffres hexadécimaux a à f sont minuscules dans la chaîne retournée. Pour les convertir en majuscules, appelez la String.ToUpper méthode sur la chaîne retournée.
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour