Guid.IFormattable.ToString(String, IFormatProvider) Metoda
Definicja
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 -> stringFunction ToString (format As String, provider As IFormatProvider) As String Implements IFormattable.ToStringParametry
- 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
Wartość tej Guid wartości reprezentowana jako seria małych cyfr szesnastkowe w określonym formacie.
Implementuje
Wyjątki
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 .