Object.ToString Metode

  • Referensi

Definisi

Ruang nama:
System
Rakitan:
System.Runtime.dll
Rakitan:
mscorlib.dll
Rakitan:
netstandard.dll
Sumber:
Object.cs
Sumber:
Object.cs
Sumber:
Object.cs

Mengembalikan string yang mewakili objek saat ini.

public:
 virtual System::String ^ ToString();
public virtual string ToString ();
public virtual string? ToString ();
abstract member ToString : unit -> string
override this.ToString : unit -> string
Public Overridable Function ToString () As String

Mengembalikan

String

String yang mewakili objek saat ini.

Keterangan

Untuk informasi selengkapnya tentang API ini, lihat Keterangan API Tambahan untuk Object.ToString.

Catatan Bagi Inheritor

Saat menerapkan jenis Anda sendiri, Anda harus mengambil alih ToString() metode untuk mengembalikan nilai yang bermakna untuk jenis tersebut. Kelas turunan yang memerlukan kontrol lebih besar atas pemformatan daripada ToString() yang disediakan dapat mengimplementasikan IFormattable antarmuka. Metodenya ToString(String, IFormatProvider) memungkinkan Anda menentukan string format yang mengontrol pemformatan dan menggunakan IFormatProvider objek yang dapat menyediakan pemformatan khusus budaya.

Penimpaan ToString() metode harus mengikuti panduan berikut:

  • String yang dikembalikan harus ramah dan dapat dibaca oleh manusia.

  • String yang dikembalikan harus mengidentifikasi nilai instans objek secara unik.

  • String yang dikembalikan harus sesingkat mungkin sehingga cocok untuk ditampilkan oleh debugger.

  • Penimpaan Anda ToString() tidak boleh mengembalikan Empty atau string null.

  • Penimpaan Anda ToString() seharusnya tidak melemparkan pengecualian.

  • Jika representasi string instans sensitif terhadap budaya atau dapat diformat dengan berbagai cara, terapkan IFormattable antarmuka.

  • Jika string yang dikembalikan menyertakan informasi sensitif, Anda harus terlebih dahulu menuntut izin yang sesuai. Jika permintaan berhasil, Anda dapat mengembalikan informasi sensitif; jika tidak, Anda harus mengembalikan string yang mengecualikan informasi sensitif.

  • Penimpaan Anda ToString() seharusnya tidak memiliki efek samping yang dapat diamati untuk menghindari komplikasi dalam penelusuran kesalahan. Misalnya, panggilan ke ToString() metode tidak boleh mengubah nilai bidang instans.

  • Jika jenis Anda menerapkan metode penguraian (atau Parse atau TryParse metode, konstruktor, atau beberapa metode statis lainnya yang membuat instans jenis dari string), Anda harus memastikan bahwa string yang dikembalikan oleh ToString() metode dapat dikonversi ke instans objek.

Berlaku untuk

Lihat juga