Guid.ToString Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Mengembalikan representasi string dari nilai instans Guid struktur ini.

Overload

ToString(String, IFormatProvider)	Mengembalikan representasi string dari nilai instans Guid kelas ini, sesuai dengan penentu format yang disediakan dan informasi format khusus budaya.
ToString()	Mengembalikan representasi string dari nilai instans ini dalam format registri.
ToString(String)	Mengembalikan representasi string dari nilai instans ini Guid , sesuai dengan penentu format yang disediakan.

ToString(String, IFormatProvider)

Sumber:

Guid.cs

Mengembalikan representasi string dari nilai instans Guid kelas ini, sesuai dengan penentu format yang disediakan dan informasi format khusus budaya.

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

Parameter

format

String

Penentu format tunggal yang menunjukkan cara memformat nilai ini Guid. Parameternya format bisa "N", "D", "B", "P", atau "X". Jika format adalah null atau string kosong (""), "D" digunakan.

provider

IFormatProvider

(Dicadangkan) Objek yang memasok informasi pemformatan khusus budaya.

Mengembalikan

String

Nilai ini Guid, direpresentasikan sebagai serangkaian digit heksadesimal huruf kecil dalam format yang ditentukan.

Penerapan

ToString(String, IFormatProvider)

Pengecualian

FormatException

Nilai format bukan null, string kosong (""), "N", "D", "B", "P", atau "X".

Keterangan

Parameter provider dicadangkan untuk digunakan di masa mendatang dan tidak berkontribusi pada eksekusi metode ini. Anda dapat meneruskan null panggilan metode.

Tabel berikut ini memperlihatkan penentu format yang diterima untuk format parameter . "0" mewakili digit; tanda hubung ("-"), kurung kurawal ("{", "}"), dan tanda kurung ("(", ")") muncul seperti yang ditunjukkan.

Penentu	Format nilai yang dikembalikan
N	32 digit: 00000000000000000000000000000000
D	32 digit dipisahkan oleh tanda hubung: 00000000-0000-0000-0000-000000000000
B	32 digit dipisahkan oleh tanda hubung, diapit kurung kurawal: {00000000-0000-0000-0000-000000000000}
P	32 digit dipisahkan oleh tanda hubung, diapit tanda kurung: (00000000-0000-0000-0000-000000000000)
X	Empat nilai heksadesimal diapit dalam kurung kurawal, di mana nilai keempat adalah subset dari delapan nilai heksadesimal yang juga diapit kurung kurawal: {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Digit heksadesimal a hingga f adalah huruf kecil dalam string yang dikembalikan. Untuk mengonversinya menjadi huruf besar, panggil String.ToUpper metode pada string yang dikembalikan.

provider Karena parameter diabaikan, Anda tidak dapat menggunakannya untuk menyediakan solusi pemformatan kustom. Untuk mewakili Guid nilai sebagai string dalam format yang tidak didukung oleh string format GUID standar, panggil String.Format(IFormatProvider, String, Object[]) metode dengan provider objek yang mengimplementasikan ICustomFormatter antarmuka dan IFormatProvider . Untuk informasi selengkapnya, lihat bagian "Pemformatan Kustom dengan ICustomFormatter" di artikel Jenis Pemformatan .

ToString()

Sumber:

Guid.cs

Mengembalikan representasi string dari nilai instans ini dalam format registri.

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Mengembalikan

String

Nilai ini Guid, diformat dengan menggunakan penentu format "D" sebagai berikut:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

di mana nilai GUID direpresentasikan sebagai serangkaian digit heksadesimal huruf kecil dalam grup 8, 4, 4, 4, dan 12 digit dan dipisahkan oleh tanda hubung. Contoh nilai pengembalian adalah "382c74c3-721d-4f34-80e5-57657b6cbc27". Untuk mengonversi digit heksadesimal dari a hingga f ke huruf besar, panggil ToUpper() metode pada string yang dikembalikan.

Keterangan

Metode ini menyediakan format GUID default yang cukup untuk penggunaan umum; namun, versi lain dari metode ini yang mengambil format parameter menyediakan beberapa variasi format umum.

ToString(String)

Sumber:

Guid.cs

Mengembalikan representasi string dari nilai instans ini Guid , sesuai dengan penentu format yang disediakan.

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

Parameter

format

String

Penentu format tunggal yang menunjukkan cara memformat nilai ini Guid. Parameternya format bisa "N", "D", "B", "P", atau "X". Jika format adalah null atau string kosong (""), "D" digunakan.

Mengembalikan

String

Nilai ini Guid, direpresentasikan sebagai serangkaian digit heksadesimal huruf kecil dalam format yang ditentukan.

Pengecualian

FormatException

Nilai format bukan null, string kosong (""), "N", "D", "B", "P", atau "X".

Keterangan

Tabel berikut ini memperlihatkan penentu format yang diterima untuk format parameter . "0" mewakili digit; tanda hubung ("-"), kurung kurawal ("{", "}"), dan tanda kurung ("(", ")") muncul seperti yang ditunjukkan.

Penentu	Format nilai yang dikembalikan
N	32 digit: 00000000000000000000000000000000
D	32 digit dipisahkan oleh tanda hubung: 00000000-0000-0000-0000-000000000000
B	32 digit dipisahkan oleh tanda hubung, diapit kurung kurawal: {00000000-0000-0000-0000-000000000000}
P	32 digit dipisahkan oleh tanda hubung, diapit tanda kurung: (00000000-0000-0000-0000-000000000000)
X	Empat nilai heksadesimal diapit dalam kurung kurawal, di mana nilai keempat adalah subset dari delapan nilai heksadesimal yang juga diapit kurung kurawal: {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Digit heksadesimal a hingga f adalah huruf kecil dalam string yang dikembalikan. Untuk mengonversinya menjadi huruf besar, panggil String.ToUpper metode pada string yang dikembalikan.