Språk

Guid.IFormattable.ToString(String, IFormatProvider) Metod

Definition

Returnerar en strängrepresentation av värdet för den här instansen enligt angiven formatspecificerare och kulturspecifik formatinformation.

 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

Parametrar

format
String

En enskild formatspecificerare som anger hur värdet för Guid. Parametern format kan vara "N", "D", "B", "P" eller "X". Om format är null eller en tom sträng (""), används "D".

provider
IFormatProvider

(Reserverad) Ett objekt som tillhandahåller kulturspecifik formateringsinformation.

Returer

Värdet för detta Guid representeras som en serie gemener hexadecimala siffror i det angivna formatet.

Implementeringar

Undantag

Värdet format för är inte null, en tom sträng (") eller någon av följande enskilda formatspecificerare:"N", "D", "B", "P" eller "X".

Kommentarer

Parametern provider är reserverad för framtida användning och bidrar inte till körningen av den här metoden. Du kan skicka null in metodanropet.

I följande tabell visas de godkända formatspecificerarna för parametern format . "0" representerar en siffra. bindestreck ("-"), klammerparenteser ("{", "}") och parenteser ("(", ")") visas som visas.

Specificerare Format för returvärde
N 32 siffror:

00000000000000000000000000000000
D 32 siffror avgränsade med bindestreck:

00000000-0000-0000-0000-000000000000
B 32 siffror avgränsade med bindestreck, omgivna av klammerparenteser:

{00000000-0000-0000-0000-000000000000}
P 32 siffror avgränsade med bindestreck, omgivna av parenteser:

(00000000-0000-0000-0000-000000000000)
X Fyra hexadecimala värden omgivna av klammerparenteser, där det fjärde värdet är en delmängd av åtta hexadecimala värden som också omges av klammerparenteser:

{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Hexadecimala siffror a till och med f är gemener i den returnerade strängen. Om du vill konvertera dem till versaler anropar String.ToUpper du metoden för den returnerade strängen.

Eftersom parametern provider ignoreras kan du inte använda den för att tillhandahålla en anpassad formateringslösning. Om du vill representera ett Guid värde som en sträng i ett format som inte stöds av standardsträngarna i GUID-format anropar String.Format(IFormatProvider, String, Object[]) du metoden med ett provider -objekt som implementerar både gränssnitten ICustomFormatter och IFormatProvider . Mer information finns i avsnittet "Anpassad formatering med ICustomFormatter" i artikeln Formateringstyper .

Gäller för