Exception.ToString Yöntem

Tanım

Geçerli özel durumun dize gösterimini oluşturur ve döndürür.

C#
public override string ToString ();

Döndürülenler

String

Geçerli özel durumun dize gösterimi.

Uygulamalar

Örnekler

Aşağıdaki örnek bir özel duruma neden olur ve bu özel durumda çağrının ToString sonucunu görüntüler. Yöntemin Exception.ToString bağımsız değişken listesinde Exception sınıf örneği göründüğünde yönteminin örtük olarak çağrıldığını Console.WriteLine unutmayın.

C#
using System;

public class TestClass
{}

public class Example
{
   public static void Main()
   {
      var test = new TestClass();
      Object[] objectsToCompare = { test, test.ToString(), 123,
                                    123.ToString(), "some text",
                                    "Some Text" };
      string s = "some text";
      foreach (var objectToCompare in objectsToCompare) {
         try {
            int i = s.CompareTo(objectToCompare);
            Console.WriteLine("Comparing '{0}' with '{1}': {2}",
                              s, objectToCompare, i);
         }
         catch (ArgumentException e) {
            Console.WriteLine("Bad argument: {0} (type {1})",
                              objectToCompare,
                              objectToCompare.GetType().Name);
            Console.WriteLine("Exception information: {0}", e);
         }
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//     Bad argument: TestClass (type TestClass)
//     Exception information: System.ArgumentException: Object must be of type String.
//        at System.String.CompareTo(Object value)
//        at Example.Main()
//
//     Comparing 'some text' with 'TestClass': -1
//
//     Bad argument: 123 (type Int32)
//     Exception information: System.ArgumentException: Object must be of type String.
//        at System.String.CompareTo(Object value)
//        at Example.Main()
//
//     Comparing 'some text' with '123': 1
//
//     Comparing 'some text' with 'some text': 0
//
//     Comparing 'some text' with 'Some Text': -1

Açıklamalar

ToString , insanlar tarafından anlaşılması amaçlanan geçerli özel durumun bir gösterimini döndürür. Özel durumun kültüre duyarlı veriler içerdiği durumlarda, tarafından döndürülen ToString dize gösteriminin geçerli sistem kültürünü hesaba katmak için gereklidir. Döndürülen dizenin biçimi için tam gereksinimler olmasa da, kullanıcı tarafından algılanan nesnenin değerini yansıtmaya çalışmalıdır.

varsayılan uygulaması ToString geçerli özel durumu oluşturan sınıfın adını, iletiyi, iç özel durumda çağırmanın ToString sonucunu ve çağırmanın Environment.StackTracesonucunu alır. Bu üyelerden herhangi biri ise null, değeri döndürülen dizeye dahil değildir.

Hata iletisi yoksa veya boş bir dizeyse (""), hata iletisi döndürülmedi. İç özel durumun adı ve yığın izlemesi yalnızca değilse nulldöndürülür.

Bu yöntem geçersiz kılar Object.ToString.

Şunlara uygulanır

Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0