Object.ToString Yöntem

  • Başvuru

Tanım

Ad Alanı:
System
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll
Kaynak:
Object.cs
Kaynak:
Object.cs
Kaynak:
Object.cs

Geçerli nesneyi temsil eden dizeyi döndürür.

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

Döndürülenler

String

Geçerli nesneyi temsil eden dize.

Açıklamalar

Bu API hakkında daha fazla bilgi için bkz . Object.ToString için ek API açıklamaları.

Devralanlara Notlar

Kendi türlerinizi uyguladığınızda, bu türler için anlamlı değerler döndürmek için yöntemini geçersiz kılmanız ToString() gerekir. Sağlanandan ToString() daha fazla biçimlendirme denetimi gerektiren türetilmiş sınıflar arabirimi uygulayabilir IFormattable . Yöntemi ToString(String, IFormatProvider) , biçimlendirmeyi denetleyan biçim dizeleri tanımlamanızı ve kültüre özgü biçimlendirme sağlayabilen bir IFormatProvider nesne kullanmanızı sağlar.

Yöntemin ToString() geçersiz kılmaları şu yönergeleri izlemelidir:

  • Döndürülen dize insanlar tarafından kolay ve okunabilir olmalıdır.

  • Döndürülen dize, nesne örneğinin değerini benzersiz olarak tanımlamalıdır.

  • Döndürülen dize, hata ayıklayıcı tarafından görüntülenmeye uygun olacak şekilde olabildiğince kısa olmalıdır.

  • Geçersiz kılmanız ToString() veya null dize döndürmemelidir Empty .

  • Geçersiz kılmanız ToString() özel durum oluşturmamalıdır.

  • Örneğin dize gösterimi kültüre duyarlıysa veya birden çok şekilde biçimlendirilebiliyorsa arabirimini IFormattable uygulayın.

  • Döndürülen dize hassas bilgiler içeriyorsa, önce uygun bir izin istemeniz gerekir. Talep başarılı olursa hassas bilgileri döndürebilirsiniz; aksi takdirde, hassas bilgileri dışlayan bir dize döndürmelisiniz.

  • Hata ayıklamadaki komplikasyonları önlemek için geçersiz kılmanızın ToString() gözlemlenebilir yan etkileri olmamalıdır. Örneğin, yöntemine yapılan ToString() bir çağrı örnek alanlarının değerini değiştirmemelidir.

  • Türünüz bir ayrıştırma yöntemi (veya Parse yöntemi TryParse , oluşturucu veya bir dizeden türün örneğini oluşturan başka bir statik yöntem) uygularsa, yöntem tarafından ToString() döndürülen dizenin bir nesne örneğine dönüştürülediğinden emin olmanız gerekir.

Şunlara uygulanır

Ayrıca bkz.