Guid.ToString Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

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

Przeciążenia

ToString(String)	Zwraca reprezentację ciągu wartości tego wystąpienia Guid 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 klasy Guid zgodnie z podanym specyfikatorem formatu i informacjami o formacie specyficznym dla kultury.

ToString(String)

Źródło:

Guid.cs

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

public:
 System::String ^ ToString(System::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 wskazujący sposób formatowania wartości tego Guid. Parametrem format może być "N", "D", "B", "P" lub "X". Jeśli format jest null lub jest używany pusty ciąg (""), "D".

Zwraca

String

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

Wyjątki

FormatException

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

Uwagi

W poniższej tabeli przedstawiono akceptowane specyfikatory formatu dla 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 zwróconego ciągu.

ToString()

Źródło:

Guid.cs

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 Guid, 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 szesnastkowej w grupach 8, 4, 4, 4, 4 i 12 cyfr i rozdzielonych łącznikami. Przykładem wartości zwracanej jest "382c74c3-721d-4f34-80e5-57657b6cbc27". Aby przekonwertować cyfry szesnastkowe od od f do wielkiej litery, wywołaj metodę ToUpper() w zwracanym ciągu.

Uwagi

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

ToString(String, IFormatProvider)

Źródło:

Guid.cs

Zwraca reprezentację ciągu wartości tego wystąpienia klasy Guid 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);

override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, provider As IFormatProvider) As String

Parametry

format

String

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

provider

IFormatProvider

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

Zwraca

String

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

Implementuje

ToString(String, IFormatProvider)

Wyjątki

FormatException

Wartość format nie jest 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 w wywołaniu metody.

W poniższej tabeli przedstawiono akceptowane specyfikatory formatu dla 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 zwróconego ciągu.

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