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.

ToStringDevuelve una representación de la excepción actual que está diseñada para ser entendida por los usuarios. Cuando la excepción contiene datos de la cuenta de la referencia cultural, la representación de cadena devueltos por ToString es necesario para tener en cuenta la referencia cultural del sistema actual. Aunque no hay ningún requisito para el formato exacto de la cadena devuelta, debería intentar reflejar el valor del objeto como percibido por 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 al método Environment.StackTrace. Si alguno de estos miembros es 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 se devuelven solo si no están null.

Este método invalida Object.ToString.

En el ejemplo siguiente se produce una excepción y muestra el resultado de llamar al método ToString en esa excepción. Tenga en cuenta que la Exception.ToString método se llama implícitamente 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: