Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Exception.ToString ()

 

Publicado: octubre de 2016

Crea y devuelve una representación de cadena de la excepción actual.

Espacio de nombres:   System
Ensamblado:  mscorlib (en mscorlib.dll)

public override string ToString()

Valor devuelto

Type: System.String

Representación de cadena de la excepción actual.

ToString Devuelve una representación de la excepción actual que se pretende sea inteligible. Cuando la excepción contiene datos de la referencia cultural, la representación de cadena devueltos por ToString es necesario tener en cuenta la referencia cultural del sistema actual. Aunque no hay ningún requisitos exactos para el formato de la cadena devuelta, debe intentar reflejar el valor del objeto como lo percibe el usuario.

La implementación predeterminada de ToString Obtiene el nombre de la clase que produjo la excepción actual, el mensaje, el resultado de llamar al método ToString en la excepción interna y el resultado de llamar a Environment.StackTrace. Si cualquiera de estos miembros se null, su valor no se incluye en la cadena devuelta.

Si no hay ningún mensaje de error o si es una cadena vacía (""), se devuelve ningún mensaje de error. El nombre de la excepción interna y el seguimiento de pila sólo se devuelven si no son null.

Este método reemplaza Object.ToString.

En el ejemplo siguiente se produce una excepción y muestra el resultado de llamar al método ToString en dicha excepción. Tenga en cuenta que el Exception.ToString se llama implícitamente al método cuando la instancia de la clase de excepción aparece en la lista de argumentos de la Console.WriteLine (método).

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

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: