Guid.ToString Methode

  • Referenz

Definition

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Gibt eine Zeichenfolgendarstellung des Werts dieser Instanz der Guid-Struktur zurück.

Überlädt

ToString(String, IFormatProvider)

Gibt eine Zeichenfolgendarstellung des Werts dieser Instanz der Guid-Klasse entsprechend dem angegebenen Formatbezeichner und den angegebenen kulturspezifischen Formatinformationen zurück.
ToString()

Gibt eine Zeichenfolgendarstellung des Werts dieser Instanz im Registrierungsformat zurück.
ToString(String)

Gibt eine Zeichenfolgendarstellung des Werts dieser Guid-Instanz entsprechend dem angegebenen Formatbezeichner zurück.

ToString(String, IFormatProvider)

Gibt eine Zeichenfolgendarstellung des Werts dieser Instanz der Guid-Klasse entsprechend dem angegebenen Formatbezeichner und den angegebenen kulturspezifischen Formatinformationen zurück.

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

Parameter

format
String

Ein einzelner Formatbezeichner, der angibt, wie der Wert dieser Guid formatiert wird. Der format-Parameter kann "N", "D", "B", "P" oder "X" sein. Wenn formatnull oder eine leere Zeichenfolge ist (""), wird "D" verwendet.

provider
IFormatProvider

(Reserviert) Ein Objekt, das kulturabhängige Formatierungsinformationen bereitstellt.

Gibt zurück

String

Der Wert dieser Guid, der als Folge von hexadezimalen, kleingeschriebenen Ziffern im angegebenen Format dargestellt wird.

Implementiert

ToString(String, IFormatProvider)

Ausnahmen

FormatException

Der Wert von format ist nicht null, keine leere Zeichenfolge ("") und nicht „N“, „D“, „B“, „P“ oder „X“.

Hinweise

Der provider Parameter ist für die zukünftige Verwendung reserviert und trägt nicht zur Ausführung dieser Methode bei. Sie können den Methodenaufruf übergeben null .

Die folgende Tabelle zeigt die akzeptierten Formatbezeichner für den format Parameter. "0" stellt eine Ziffer dar; Bindestriche ("-"), Klammern ("{", "}") und Klammern ("(", ")") werden wie gezeigt angezeigt angezeigt.

Bezeichner Format des Rückgabewerts
N 32 Ziffern:

00000000000000000000000000000000
D 32 Ziffern durch Bindestriche getrennt:

00000000-0000-0000-0000-000000000000
B 32 Ziffern getrennt durch Bindestriche, in Klammern eingeschlossen:

{00000000-0000-0000-0000-000000000000}
P 32 Ziffern getrennt durch Bindestriche, in Klammern eingeschlossen:

(00000000-0000-0000-0000-000000000000)
X Vier hexadezimale Werte, die in Klammern eingeschlossen sind, wobei der vierte Wert eine Teilmenge von acht Hexadezimalwerten ist, die auch in Klammern eingeschlossen sind:

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

Die hexadezimalen Ziffern a bis f sind Kleinbuchstaben in der zurückgegebenen Zeichenfolge. Um sie in Großbuchstaben zu konvertieren, rufen Sie die String.ToUpper -Methode für die zurückgegebene Zeichenfolge auf.

Da der provider Parameter ignoriert wird, können Sie ihn nicht verwenden, um eine benutzerdefinierte Formatierungslösung bereitzustellen. Um einen Guid Wert als Zeichenfolge in einem Format darzustellen, das von den Standard-GUID-Formatzeichenfolgen nicht unterstützt wird, rufen Sie die String.Format(IFormatProvider, String, Object[]) -Methode mit einem provider -Objekt auf, das sowohl die ICustomFormatterIFormatProvider Schnittstellen als auch implementiert. Weitere Informationen finden Sie im Abschnitt "Benutzerdefinierte Formatierung mit ICustomFormatter" im Artikel Formatierungstypen .

Gilt für:

ToString()

Gibt eine Zeichenfolgendarstellung des Werts dieser Instanz im Registrierungsformat zurück.

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

Gibt zurück

String

Der Wert dieser Guid, wie folgt mit dem Formatbezeichner "D" formatiert:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Dabei wird der Wert der GUID als Folge von hexadezimalen, klein geschriebenen Ziffern in Gruppen von 8, 4, 4, 4 und 12 Ziffern dargestellt, die durch Bindestriche voneinander getrennt sind. Ein Beispiel eines Rückgabewerts ist "382c74c3-721d-4f34-80e5-57657b6cbc27". Um die Hexadezimalzeichen von a bis f in Großbuchstaben zu konvertieren, rufen Sie die ToUpper()- Methode auf der zurückgegebenen Zeichenfolge auf.

Hinweise

Diese Methode stellt ein Standard-GUID-Format bereit, das für die typische Verwendung ausreichend ist. Andere Versionen dieser Methode, die einen format Parameter verwenden, bieten jedoch einige gängige Formatvariationen.

Gilt für:

ToString(String)

Gibt eine Zeichenfolgendarstellung des Werts dieser Guid-Instanz entsprechend dem angegebenen Formatbezeichner zurück.

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

Parameter

format
String

Ein einzelner Formatbezeichner, der angibt, wie der Wert dieser Guid formatiert wird. Der format-Parameter kann "N", "D", "B", "P" oder "X" sein. Wenn formatnull oder eine leere Zeichenfolge ist (""), wird "D" verwendet.

Gibt zurück

String

Der Wert dieser Guid, der als Folge von hexadezimalen, kleingeschriebenen Ziffern im angegebenen Format dargestellt wird.

Ausnahmen

FormatException

Der Wert von format ist nicht null, keine leere Zeichenfolge ("") und nicht „N“, „D“, „B“, „P“ oder „X“.

Hinweise

Die folgende Tabelle zeigt die akzeptierten Formatbezeichner für den format Parameter. "0" stellt eine Ziffer dar; Bindestriche ("-"), Klammern ("{", "}") und Klammern ("(", ")") werden wie gezeigt angezeigt angezeigt.

Bezeichner Format des Rückgabewerts
N 32 Ziffern:

00000000000000000000000000000000
D 32 Ziffern durch Bindestriche getrennt:

00000000-0000-0000-0000-000000000000
B 32 Ziffern getrennt durch Bindestriche, in Klammern eingeschlossen:

{00000000-0000-0000-0000-000000000000}
P 32 Ziffern getrennt durch Bindestriche, in Klammern eingeschlossen:

(00000000-0000-0000-0000-000000000000)
X Vier hexadezimale Werte, die in Klammern eingeschlossen sind, wobei der vierte Wert eine Teilmenge von acht Hexadezimalwerten ist, die auch in Klammern eingeschlossen sind:

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

Die hexadezimalen Ziffern a bis f sind Kleinbuchstaben in der zurückgegebenen Zeichenfolge. Um sie in Großbuchstaben zu konvertieren, rufen Sie die String.ToUpper -Methode für die zurückgegebene Zeichenfolge auf.

Gilt für: