Guid.ToString Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

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

Überlädt

ToString(String)	Gibt eine Zeichenfolgendarstellung des Werts dieser Guid Instanz gemäß dem bereitgestellten Formatbezeichner zurück.
ToString()	Gibt eine Zeichenfolgendarstellung des Werts dieser Instanz im Registrierungsformat zurück.
ToString(String, IFormatProvider)	Gibt eine Zeichenfolgendarstellung des Werts dieser Instanz der Guid Klasse gemäß den bereitgestellten Formatbezeichner- und kulturspezifischen Formatinformationen zurück.

ToString(String)

Quelle:

Guid.cs

Gibt eine Zeichenfolgendarstellung des Werts dieser Guid Instanz gemäß dem bereitgestellten Formatbezeichner zurück.

public:
 System::String ^ ToString(System::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 dieses Guidformatiert 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, dargestellt als Eine Reihe von Hexadezimalziffern in Kleinbuchstaben im angegebenen Format.

Ausnahmen

FormatException

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

Hinweise

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

Spezifikationssymbol	Format des Rückgabewerts
N	32 Ziffern: 00000000000000000000000000000000
D	32 Ziffern getrennt durch Bindestriche: 00000000-0000-0000-0000-000000000000
B	32 Ziffern getrennt durch Bindestriche, eingeschlossen in geschweifte Klammern: {00000000-0000-0000-0000-000000000000}
P	32 Ziffern getrennt durch Bindestriche, eingeschlossen in Klammern: (00000000-0000-0000-0000-000000000000)
X	Vier hexadezimale Werte, die in geschweifte Klammern eingeschlossen sind, wobei der vierte Wert eine Teilmenge von acht Hexadezimalwerten ist, die ebenfalls in geschweifte Klammern eingeschlossen sind: {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

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

ToString()

Quelle:

Guid.cs

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 dieses Guid, formatiert mit dem Formatbezeichner "D" wie folgt:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

wobei der Wert der GUID als Eine Reihe von Hexadezimalziffern in Gruppen von 8, 4, 4, 4, 4 und 12 Ziffern dargestellt und durch Bindestriche getrennt wird. Ein Beispiel für einen Rückgabewert ist "382c74c3-721d-4f34-80e5-57657b6cbc27". Rufen Sie die ToUpper()-Methode für die zurückgegebene Zeichenfolge auf, um die hexadezimalen Ziffern von einer bis f in Großbuchstaben zu konvertieren.

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, stellen jedoch einige gängige Formatvarianten bereit.

ToString(String, IFormatProvider)

Quelle:

Guid.cs

Gibt eine Zeichenfolgendarstellung des Werts dieser Instanz der Guid Klasse gemäß den bereitgestellten Formatbezeichner- und kulturspezifischen Formatinformationen zurück.

public:
 virtual System::String ^ ToString(System::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 dieses Guidformatiert 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 kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Der Wert dieser Guid, dargestellt als Eine Reihe von Hexadezimalziffern in Kleinbuchstaben im angegebenen Format.

Implementiert

ToString(String, IFormatProvider)

Ausnahmen

FormatException

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

Hinweise

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

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

Spezifikationssymbol	Format des Rückgabewerts
N	32 Ziffern: 00000000000000000000000000000000
D	32 Ziffern getrennt durch Bindestriche: 00000000-0000-0000-0000-000000000000
B	32 Ziffern getrennt durch Bindestriche, eingeschlossen in geschweifte Klammern: {00000000-0000-0000-0000-000000000000}
P	32 Ziffern getrennt durch Bindestriche, eingeschlossen in Klammern: (00000000-0000-0000-0000-000000000000)
X	Vier hexadezimale Werte, die in geschweifte Klammern eingeschlossen sind, wobei der vierte Wert eine Teilmenge von acht Hexadezimalwerten ist, die ebenfalls in geschweifte Klammern eingeschlossen sind: {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

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

Da der parameter provider 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 standardmäßigen GUID-Formatzeichenfolgen nicht unterstützt wird, rufen Sie die String.Format(IFormatProvider, String, Object[])-Methode mit einem provider-Objekt auf, das sowohl die ICustomFormatter als auch IFormatProvider Schnittstellen implementiert. Weitere Informationen finden Sie im Abschnitt "Benutzerdefinierte Formatierung mit ICustomFormatter" im Artikel Formatierungstypen Artikel.