Guid.IFormattable.ToString(String, IFormatProvider) Méthode

Définition

Espace de noms:
System
Assemblys:
mscorlib.dll, System.Runtime.dll
Assembly:
System.Runtime.dll

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

 virtual System::String ^ System.IFormattable.ToString(System::String ^ format, IFormatProvider ^ provider) = IFormattable::ToString;
string IFormattable.ToString(string format, IFormatProvider provider);
abstract member System.IFormattable.ToString : string * IFormatProvider -> string
override this.System.IFormattable.ToString : string * IFormatProvider -> string
Function ToString (format As String, provider As IFormatProvider) As String Implements IFormattable.ToString

Paramètres

format
String

Spécificateur de format unique qui indique comment mettre en forme la valeur du Guid. Le format paramètre peut être « N », « D », « B », « P » ou « X ». S’il format s’agit de null ou d’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 valeur 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 («  »), ou l’un des spécificateurs de format unique suivants : « N », « D », « B », « P » ou « 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 présente les spécificateurs de format acceptés pour le format paramètre. « 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 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 forme de 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 interfaces et ICustomFormatter les IFormatProvider interfaces. Pour plus d’informations, consultez la section « Mise en forme personnalisée avec ICustomFormatter » dans l’article Types de mise en forme .

S’applique à