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 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 -> stringFunction ToString (format As String, provider As IFormatProvider) As String Implements IFormattable.ToStringParameter
- 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
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 ".