Guid.ToString Methode

Definition

Namespace:: System

Assemblys:: mscorlib.dll, System.Runtime.dll

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Überlädt

Name	Beschreibung
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

Quelle:: Guid.cs

Quelle:: Guid.cs

Quelle:: Guid.cs

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);

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 GuidWerts formatiert wird. Der format Parameter kann "N", "D", "B", "P" oder "X" sein. Wenn format es null sich um eine leere Zeichenfolge ("") handelt, wird "D" verwendet.

Gibt zurück

String

Der Wert dieses GuidWerts , dargestellt als Eine Reihe von Hexadezimalziffern in Kleinbuchstaben im angegebenen Format.

Ausnahmen

FormatException

Der Wert lautet format nicht null, eine leere Zeichenfolge (""), "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 ("-"), 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.

Gilt für:

ToString()

Quelle:: Guid.cs

Quelle:: Guid.cs

Quelle:: Guid.cs

Quelle:: Guid.cs

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 GuidFormats, 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 Methode für die zurückgegebene Zeichenfolge auf ToUpper() , 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 Formatvariationen bereit.

Gilt für:

ToString(String, IFormatProvider)

Quelle:: Guid.cs

Quelle:: Guid.cs

Quelle:: Guid.cs

Quelle:: Guid.cs

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);

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

provider: IFormatProvider

(Reserviert) Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Der Wert dieses GuidWerts , dargestellt als Eine Reihe von Hexadezimalziffern in Kleinbuchstaben im angegebenen Format.

Implementiert

ToString(String, IFormatProvider)

Ausnahmen

FormatException

Der Wert lautet format nicht null, eine leere Zeichenfolge (""), "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 .

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}}

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 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 als ICustomFormatter auch die IFormatProvider Schnittstellen implementiert. Weitere Informationen finden Sie im Abschnitt "Benutzerdefinierte Formatierung mit ICustomFormatter" im Artikel "Formatierungstypen ".

Gilt für:

Feedback

War diese Seite hilfreich?