Bu sayfa faydalı mıydı?
Bu içerik hakkındaki geri bildiriminiz önemli. Ne düşündüğünüzü bilmemize izin verin.
İlave geri bildirim?
1500 karakter kaldı
Dışarıya aktar (0) Yazdır
Tümünü Genişlet
Bu makale makine tarafından çevrilmiştir. Orijinal metni görmek için imlecinizi makaledeki cümlelerin üzerine getirin. Daha Fazla Bilgi.
Çeviri
Original

Object.ToString Yöntem

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

Ad alanı:  System
Derleme:  mscorlib (mscorlib.dll içinde)

public virtual string ToString()

Dönüş Değeri

Tür: System.String
Geçerli nesneyi temsil eden bir dize.

ToString temel .NET Framework yönteminde biçimlendiriyor. Görüntülemek için uygun olması için bir nesneyi dize karþýlýðýna dönüştürür. (.NET Framework desteği biçimlendirme hakkında daha fazla bilgi için bkz: Biçimlendirme Türleri.)

Varsayılan uygulama, ToString yöntemi türünü tam nitelikli adını döndürür Object, aşağıdaki örnekte gösterildiği gibi.


using System;

public class Example
{
   public static void Main()
   {
      Object obj = new Object();
      Console.WriteLine(obj.ToString());
   }
}
// The example displays the following output:
//      System.Object


Çünkü Object tüm baþvuru türleri, temel sınıf .NET Framework, bu davranışı geçersiz başvuru türleri tarafından devralındı ToString yöntem. Aşağıdaki örnek bunu göstermektedir. Adında bir sınıfı tanımlar Object1 kabul eden tüm varsayılan uygulama Object üyeleri. Kendi ToString yöntemi nesnenin tam tür adı verir.


using System;
using Examples;

namespace Examples
{
   public class Object1
   {
   }
}

public class Example
{
   public static void Main()
   {
      object obj1 = new Object1();
      Console.WriteLine(obj1.ToString());
   }
}
// The example displays the following output:
//   Examples.Object1


Türleri genellikle geçersiz ToString yöntemi nesne örneğini temsil eden bir dize döndürür. Örneğin, temel gibi türleri Char, Int32, ve String sağlayan ToString nesnesini temsil eden değeri dizesi dönüş uygulamaları. Aşağıdaki örnek, bir sınıfı tanımlar Object2, bu geçersiz kılar ToString değerinin yanı sıra türü adını döndürmek için yöntem.


using System;

public class Object2
{
   private object value;

   public Object2(object value)
   {
      this.value = value;
   }

   public override string ToString()
   {
      return base.ToString() + ": " + value.ToString();
   }
}

public class Example
{
   public static void Main()
   {
      Object2 obj2 = new Object2('a');
      Console.WriteLine(obj2.ToString());
   }
}
// The example displays the following output:
//       Object2: a


Windows Çalışma Zamanı ile İlgili Notlar

Çağırdığınızda ToString bir sınıfta yöntemi Windows Çalışma Zamanı, varsayılan davranışı geçersiz kılmaz sınıfları için sağladığı ToString. Bu, .NET Framework'ün Windows Çalışma Zamanı için sağladığı desteğin bir parçasıdır (bkz: Windows Mağazası Uygulamaları ve Windows Çalışma Zamanı için .NET Framework Desteği). Sınıflar Windows Çalışma Zamanı almazlar Objectve her zaman olmayan bir ToString. Ancak, bunlar her zaman gibi görünüyor ToString, Equals(Object), ve GetHashCode yöntemleri, C# veya Visual Basic kodunuzda kullanmak ve .NET Framework varsayılan davranışı için bu yöntemleri sağlar.

Başlayarak .NET Framework 4.5.1, ortak dil çalışma zamanı kullanır IStringable.ToString üzerinde bir Windows Çalışma Zamanı nesne için varsayılan uygulamasını düşülüyor önce Object.ToString.

NotNot

Windows Çalışma ZamanıC# veya Visual Basic ile yazılmış sınıfları getirebileceðiniz ToString yöntem.

7bxwbwt2.collapse_all(tr-tr,VS.110).gifWindows Çalışma Zamanı ve IStringable Arabirimi

Başlayarak Windows 8.1, Windows Çalışma Zamanı içeren bir IStringable , tek bir yöntem arabirim IStringable.ToString, temel biçimlendirme destek sağladığı için karşılaştırılabilir sağlar Object.ToString. Belirsizlik önlemek için değil uygulamanız IStringable yönetilen türler üzerinde.

Ne zaman yönetilen nesneleri denir JavaScript veya C + gibi dillerde yazılmış kod veya yerel kod tarafından +/ CX, göründükleri uygulamak için IStringable. Ortak dil çalışma zamanı gelen çağrıları otomatik olarak yönlendirecek IStringable.ToString için Object.ToString olay IStringable yönetilen nesne üzerinde uygulanmadı.

Uyarı notuUyarı

Ortak dil çalışma zamanı otomatik uyguladığı çünkü IStringable tüm yönetilen türler içinde Windows Mağazası apps, öneririz, kendi sağlamak için değil, IStringable uygulaması. Uygulama IStringable çağrılırken istenmeyen davranışlara neden olabilir ToString gelen Windows Çalışma Zamanı, C + +/ CX veya JavaScript.

Uygulamak seçerseniz, IStringable içinde verilen ortak bir yönetilen türde bir Windows Çalışma Zamanı bileşeni, aşağıdaki kısıtlamalar geçerlidir:

  • Tanımlayabileceğiniz IStringable gibi yalnızca bir "uygulayan sınıf" ilişkide, arabirim

    public class NewClass : IStringable
    

    C# [NULL]'ta, veya

    Public Class NewClass : Implements IStringable
    

    bir Visual Basic.

  • Siz uygulayamaz IStringable bir arabirim üzerinde.

  • Bir parametre türünde bildirilemez IStringable.

  • IStringable yöntem, özellik veya alan dönüş türü olamaz.

  • Saklanamazsınız, IStringable bir yöntem tanımı aşağıdaki gibi kullanarak temel sınıflardan uygulaması:

    
    public class NewClass : IStringable
    {
       public new string ToString()
       {
          return "New ToString in NewClass";
       }
    }
    
    

    Bunun yerine, IStringable.ToString uygulama her zaman geçersiz kılması gerekir temel sınıf uygulama. Gizlemek bir ToString türü kesin belirlenmiş sınıf örneğinde çağırma tarafından yalnızca uygulama.

Çeşitli koşullar altında uygulayan yönetilen bir tür yerel koddan çağıran dikkat edin IStringable ya da gizler onun ToString uygulaması, beklenmeyen bir davranış üretmek.

Devralanlara Notlar

Kendi türleriniz uygularken geçersiz kılmak ToString bu türleri için anlamlı olan değerleri elde etmek için yöntem. Türetilen'den biçimlendirme üzerinde daha fazla denetim gereken sınıflar ToString sağlar uygulayabilirsiniz IFormattable arabirim. Kendi IFormattable.ToString(String, IFormatProvider) yöntemi sağlar biçimlendirmeyi denetlemek biçim dizeleri tanımlamak ve kullanmak için bir IFormatProvider kültüre özgü biçimlendirme için sağlayan nesne.

Geçersiz kılar, ToString yöntemi, şu yönergeleri izleyin:

  • 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.

  • Böylece uygun bir hata ayıklayıcı tarafından görüntülenecek döndürülen dize mümkün olduğu kadar kısa olmalıdır.

  • Sizin ToString geçersiz kılma yok dönmesi gerektiğini String.Empty ya da boş dize.

  • Sizin ToString geçersiz kılma özel bir durum değil oluşturması.

  • Örnek dize gösterimini kültüre duyarlı ya da birden çok yolla biçimlendirilemez uygulamak IFormattable arabirim.

  • Döndürülen dize hassas bilgiler içeriyorsa, önce bir uygun izni talep. İstek başarılı olursa, hassas bilgileri döndürebilirsiniz; Aksi takdirde, önemli bilgilerin dışlayan bir dize döndürmelidir.

  • Sizin ToString geçersiz kılma, hata ayıklama, zorluklar önlemek için observable hiçbir yan etkilere sahip olmalıdır. Örneğin, bir çağrı ToString yöntemi örnek alanların değerini değiştirme.

  • Türünüzü ayrıştırma yöntemi uyguluyorsa (ya da Parse veya TryParse yöntemi, bir kurucu veya bir dizeden türünün bir örneğini oluşturan başka statik bir yöntem), tarafından döndürülen dize emin ToString yöntem bir nesne örneğine dönüştürülebilir.

.NET Framework

Destekleyen: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework İstemci Profili

Destekleyen: 4, 3.5 SP1

Taşınabilir Sınıf Kitaplığı

Destekleyen: Taşınabilir Sınıf Kitaplığı

Windows Mağazası uygulamaları için .NET

Destekleyen: Windows 8

Windows Phone uygulamaları için .NET

Destekleyen: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Sunucu Çekirdeği Rolü desteklenmez), Windows Server 2008 R2 (Sunucu Çekirdeği Rolü, SP1 veya sonraki sürümlerle desteklenir; Itanium'da desteklenmez)

.NET Framework her platformun tüm sürümlerini desteklemez. Desteklenen sürümlerin listesi için bkz. .NET Framework Sistem Gereksinimleri.

Topluluk İçeriği

Ekle
Show:
© 2015 Microsoft