Guid.ToString Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Mengembalikan representasi string dari nilai instans struktur Guid ini.

Overload

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

ToString(String)

Sumber:

Guid.cs

Mengembalikan representasi string dari nilai instans Guid ini, 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 Guidini. Parameter format dapat berupa "N", "D", "B", "P", atau "X". Jika formatnull atau string kosong (""), "D" digunakan.

Mengembalikan

String

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

Pengecualian

FormatException

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

Keterangan

Tabel berikut ini memperlihatkan penentu format yang diterima untuk parameter format. "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 dalam kurung kurawal: {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

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

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 Guidini , diformat dengan menggunakan penentu format "D" sebagai berikut:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

di mana nilai GUID diwakili 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 hingga f ke huruf besar, panggil metode ToUpper() pada string yang dikembalikan.

Keterangan

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

ToString(String, IFormatProvider)

Sumber:

Guid.cs

Mengembalikan representasi string dari nilai instans ini dari kelas Guid, 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 Guidini. Parameter format dapat berupa "N", "D", "B", "P", atau "X". Jika formatnull atau string kosong (""), "D" digunakan.

provider

IFormatProvider

(Dicadangkan) Objek yang memasok informasi pemformatan khusus budaya.

Mengembalikan

String

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

Penerapan

ToString(String, IFormatProvider)

Pengecualian

FormatException

Nilai format tidak 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 dalam panggilan metode.

Tabel berikut ini memperlihatkan penentu format yang diterima untuk parameter format. "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 dalam kurung kurawal: {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

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

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