Język

Guid.IFormattable.ToString(String, IFormatProvider) Metoda

Definicja

Przestrzeń nazw:
System
Zestawy:
mscorlib.dll, System.Runtime.dll
Zestaw:
System.Runtime.dll

Zwraca ciąg reprezentujący wartość tego wystąpienia zgodnie z podanym specyfikatorem formatu i informacjami o formacie specyficznym dla kultury.

 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

Parametry

format
String

Specyfikator pojedynczego formatu wskazujący sposób formatowania wartości .Guid Parametr format może mieć wartość "N", "D", "B", "P" lub "X". Jeśli format parametr ma wartość null lub pusty ciąg (""), "D" jest używany.

provider
IFormatProvider

(Zarezerwowane) Obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury.

Zwraca

String

Wartość tej Guid wartości reprezentowana jako seria małych cyfr szesnastkowe w określonym formacie.

Implementuje

ToString(String, IFormatProvider)

Wyjątki

FormatException

Wartość format nie ma wartości null, pusty ciąg ("") lub jeden z następujących specyfikatorów pojedynczego formatu:"N", "D", "B", "P" lub "X".

Uwagi

Parametr provider jest zarezerwowany do użycia w przyszłości i nie przyczynia się do wykonania tej metody. Możesz przekazać null wywołanie metody.

W poniższej tabeli przedstawiono zaakceptowane specyfikatory formatu parametru format . "0" reprezentuje cyfrę; łączniki ("-"), nawiasy klamrowe ("{", "}") i nawiasy ("(", ")") są wyświetlane w sposób pokazany.

Specyfikator Format wartości zwracanej
N 32 cyfry:

00000000000000000000000000000000
D 32 cyfry oddzielone łącznikami:

00000000-0000-0000-0000-000000000000
B 32 cyfry oddzielone łącznikami, ujęte w nawiasy klamrowe:

{00000000-0000-0000-0000-000000000000}
P 32 cyfry oddzielone łącznikami, ujęte w nawiasy:

(00000000-0000-0000-0000-000000000000)
X Cztery wartości szesnastkowe ujęte w nawiasy klamrowe, gdzie czwarta wartość jest podzbiorem ośmiu wartości szesnastkowej, które są również ujęte w nawiasy klamrowe:

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

Cyfry szesnastkowe od f są małymi literami w zwracanym ciągu. Aby przekonwertować je na wielkie litery, wywołaj metodę String.ToUpper w zwracanym ciągu.

provider Ponieważ parametr jest ignorowany, nie można go użyć do udostępnienia niestandardowego rozwiązania formatowania. Aby reprezentować Guid wartość jako ciąg w formacie, który nie jest obsługiwany przez standardowe ciągi formatu GUID, wywołaj String.Format(IFormatProvider, String, Object[]) metodę za pomocą provider obiektu, który implementuje zarówno interfejsy , jak ICustomFormatter i IFormatProvider . Aby uzyskać więcej informacji, zobacz sekcję "Niestandardowe formatowanie przy użyciu formatu ICustomFormatter" w artykule Typy formatowania .

Dotyczy