Object.ToString Yöntem

Tanım

Ad Alanı:
System
Bütünleştirilmiş Kodlar:
mscorlib.dll, System.Runtime.dll
Bütünleştirilmiş Kodlar:
netstandard.dll, System.Runtime.dll
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
Kaynak:
Object.cs
Kaynak:
Object.cs

Geçerli nesneyi temsil eden bir dize 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 bir 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. Biçimlendirme üzerinde sağlanandan ToString() daha fazla denetim 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 kolay ve insanlar tarafından 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 mümkün olduğunca 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 ParseTryParse yöntemi, oluşturucu veya bir dizeden türün örneğini oluşturan başka bir statik yöntem) uygularsa, yöntemi tarafından döndürülen dizenin ToString() nesne örneğine dönüştürülediğinden emin olmanız gerekir.

Şunlara uygulanır

Ayrıca bkz.

  • .NET'da Biçimlendirme Türleri