Guid.IFormattable.ToString(String, IFormatProvider) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System

Zestaw:: System.Runtime.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zwraca reprezentację ciągu wartości 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, który wskazuje sposób formatowania wartości elementu Guid. Parametr format może mieć wartość "N", "D", "B", "P" lub "X". Jeśli format parametr ma wartość null lub pusty ciąg (""), jest używany znak "D".

provider: IFormatProvider

(Parametr zarezerwowany) Obiekt dostarczający informacji o formatowaniu specyficznych 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ść nie format 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 akceptowane specyfikatory formatu dla parametru format . Znak „0” reprezentuje cyfrę. Łączniki („-”), nawiasy klamrowe („{”, „}”) i nawiasy („(”, „)”) są wyświetlane jak pokazano.

Specyfikator	Format wartości zwracanej
`N`	32 cyfry: 00000000000000000000000000000000
`D`	32 cyfry rozdzielone łącznikami: 00000000-0000-0000-0000-000000000000
`B`	32 cyfry rozdzielone łącznikami, ujęte w nawiasach klamrowych: {00000000-0000-0000-0000-000000000000}
`P`	32 cyfry rozdzielone łącznikami, ujęte w nawiasach: (00000000-0000-0000-0000-000000000000)
`X`	Cztery wartości szesnastkowe zawarte w nawiasach klamrowych, gdzie czwarta wartość jest podzbiorem ośmiu wartości szesnastkowych również ujętych 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 provider pomocą obiektu, który implementuje zarówno ICustomFormatter interfejsy, jak i IFormatProvider . Aby uzyskać więcej informacji, zobacz sekcję "Niestandardowe formatowanie przy użyciu formatu ICustomFormatter" w artykule Typy formatowania .

Dotyczy