Guid.IFormattable.ToString(String, IFormatProvider) Methode
Definition
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 gemäß den bereitgestellten Formatbezeichner- und 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 -> stringFunction ToString (format As String, provider As IFormatProvider) As String Implements IFormattable.ToStringParameter
- format
- String
Ein einzelner Formatbezeichner, der angibt, wie der Wert der Guid. Der format Parameter kann "N", "D", "B", "P" oder "X" sein. Ist format null oder eine leere Zeichenfolge (""), wird "D" verwendet.
- provider
- IFormatProvider
(Reserviert) Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.
Gibt zurück
Der Wert dieses Werts Guid , der als Eine Reihe von Hexadezimalziffern in Kleinbuchstaben im angegebenen Format dargestellt wird.
Implementiert
Ausnahmen
Der Wert von format ist nicht NULL, eine leere Zeichenfolge ("") oder eine der folgenden Einzelnen Formatbezeichner:"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.
| 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 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 ".
