Guid.ToString Metod

Definition

Namnområde:
System
Sammansättningar:
mscorlib.dll, System.Runtime.dll
Sammansättningar:
netstandard.dll, System.Runtime.dll
Sammansättning:
System.Runtime.dll
Sammansättning:
mscorlib.dll
Sammansättning:
netstandard.dll

Returnerar en strängrepresentation av värdet för den här instansen Guid av strukturen.

Överlagringar

Name Description
ToString(String)

Returnerar en strängrepresentation av värdet för den här Guid instansen enligt den angivna formatspecificeraren.
ToString()

Returnerar en strängrepresentation av värdet för den här instansen i registerformat.
ToString(String, IFormatProvider)

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

ToString(String)

Källa:
Guid.cs
Källa:
Guid.cs
Källa:
Guid.cs
Källa:
Guid.cs
Källa:
Guid.cs

Returnerar en strängrepresentation av värdet för den här Guid instansen enligt den angivna formatspecificeraren.

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

Parametrar

format
String

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

Returer

String

Värdet för den här Guid, som representeras som en serie gemener med hexadecimala siffror i det angivna formatet.

Undantag

FormatException

Värdet format för är inte null, en tom sträng (""), "N", "D", "B", "P" eller "X".

Kommentarer

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.

Gäller för

ToString()

Källa:
Guid.cs
Källa:
Guid.cs
Källa:
Guid.cs
Källa:
Guid.cs
Källa:
Guid.cs

Returnerar en strängrepresentation av värdet för den här instansen i registerformat.

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

Returer

String

Värdet för detta Guid, formaterat med hjälp av formatspecificeraren "D" enligt följande:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

där värdet för GUID representeras som en serie gemener med hexadecimala siffror i grupper om 8, 4, 4, 4 och 12 siffror och avgränsas med bindestreck. Ett exempel på ett returvärde är "382c74c3-721d-4f34-80e5-57657b6cbc27". Om du vill konvertera hexadecimala siffror från a till versaler anropar ToUpper() du metoden för den returnerade strängen.

Kommentarer

Den här metoden tillhandahåller ett guid-standardformat som är tillräckligt för vanlig användning. Andra versioner av den här metoden som använder en format parameter ger dock några vanliga formatvariationer.

Gäller för

ToString(String, IFormatProvider)

Källa:
Guid.cs
Källa:
Guid.cs
Källa:
Guid.cs
Källa:
Guid.cs
Källa:
Guid.cs

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

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

Parametrar

format
String

En enskild formatspecificerare som anger hur värdet för detta Guidska formateras. 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

String

Värdet för den här Guid, som representeras som en serie gemener med hexadecimala siffror i det angivna formatet.

Implementeringar

ToString(String, IFormatProvider)

Undantag

FormatException

Värdet format för är inte null, en tom sträng (""), "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