Guid.ToString Metoda

Definicja

Zwraca ciąg reprezentujący wartość tego wystąpienia Guid struktury.

Przeciążenia

ToString(String)

Zwraca reprezentację ciągu wartości tego Guid wystąpienia zgodnie z podanym specyfikatorem formatu.

ToString()

Zwraca ciąg reprezentujący wartość tego wystąpienia w formacie rejestru.

ToString(String, IFormatProvider)

Zwraca reprezentację ciągu wartości tego wystąpienia Guid klasy zgodnie z podanym specyfikatorem formatu i informacjami o formacie specyficznym dla kultury.

ToString(String)

Zwraca reprezentację ciągu wartości tego Guid wystąpienia zgodnie z podanym specyfikatorem formatu.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
public string ToString (string? format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Parametry

format
String

Specyfikator pojedynczego formatu, który wskazuje, jak sformatować wartość tego Guidelementu . Parametr format może mieć wartość "N", "D", "B", "P" lub "X". Jeśli format jest lub null pusty ciąg (""), "D" jest używany.

Zwraca

String

Wartość tego Guidelementu , reprezentowana jako seria małych cyfr szesnastkowe w określonym formacie.

Wyjątki

Wartość to format nie null, pusty ciąg (""), "N", "D", "B", "P" lub "X".

Uwagi

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.

Dotyczy

ToString()

Zwraca ciąg reprezentujący wartość tego wystąpienia w formacie rejestru.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Zwraca

String

Wartość tego Guidelementu , sformatowana przy użyciu specyfikatora formatu "D" w następujący sposób: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

gdzie wartość identyfikatora GUID jest reprezentowana jako seria małych cyfr szesnastkowe w grupach 8, 4, 4, 4, 4 i 12 cyfr i rozdzielonych łącznikami. Przykładem zwracanej wartości jest "382c74c3-721d-4f34-80e5-57657b6cbc27". Aby przekonwertować cyfry szesnastkowe z od f do wielkiej litery, wywołaj ToUpper() metodę w zwracanym ciągu.

Uwagi

Ta metoda udostępnia domyślny format identyfikatora GUID, który jest wystarczający do typowego użycia; jednak inne wersje tej metody, które przyjmują format parametr, zapewniają kilka typowych odmian formatu.

Dotyczy

ToString(String, IFormatProvider)

Zwraca reprezentację ciągu wartości tego wystąpienia Guid klasy zgodnie z podanym specyfikatorem formatu i informacjami o formacie specyficznym dla kultury.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (string? format, IFormatProvider? provider);
public string ToString (string format, IFormatProvider provider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

Parametry

format
String

Specyfikator pojedynczego formatu, który wskazuje, jak sformatować wartość tego Guidelementu . Parametr format może mieć wartość "N", "D", "B", "P" lub "X". Jeśli format jest lub null pusty ciąg (""), "D" jest używany.

provider
IFormatProvider

(Parametr zarezerwowany) Obiekt dostarczający informacji o formatowaniu specyficznych dla kultury.

Zwraca

String

Wartość tego Guidelementu , reprezentowana jako seria małych cyfr szesnastkowe w określonym formacie.

Implementuje

Wyjątki

Wartość to format nie null, pusty ciąg (""), "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