Udostępnij za pośrednictwem


Guid.IFormattable.ToString(String, IFormatProvider) Metoda

Definicja

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

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 .

Dotyczy