Freigeben über


Guid.IFormattable.ToString(String, IFormatProvider) Methode

Definition

Gibt eine Zeichenfolgendarstellung des Werts dieser Instanz entsprechend dem angegebenen Formatspezifizierer und den angegebenen kulturspezifischen Formatinformationen zurück.

 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

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 format NULL 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

Ausnahmen

Der Wert von format ist nicht NULL, eine leere Zeichenfolge ("") oder einer der folgenden einzelnen Formatspezifizierer: "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 ("-"), geschweifte Klammern ("{", "}") und Klammern ("(", ")") werden wie dargestellt angezeigt.

Bezeichner Format des Rückgabewerts
N 32 Ziffern:

00000000000000000000000000000000
D 32 Ziffern durch Trennstriche getrennt:

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 Trennstriche, 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 auch in geschweifte Klammern eingeschlossen sind:

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

Die hexadezimalen Ziffern einer durch f sind kleingeschrieben in der zurückgegebenen Zeichenfolge. Rufen Sie die Methode für die String.ToUpper zurückgegebene Zeichenfolge auf, um sie in Großbuchstaben zu konvertieren.

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

Gilt für