Exporter (0) Imprimer
Développer tout

Exception.ToString, méthode

Mise à jour : novembre 2007

Crée et retourne une chaîne représentant l'exception en cours.

Espace de noms :  System
Assembly :  mscorlib (dans mscorlib.dll)

public override string ToString()
public String ToString()
public override function ToString() : String

Valeur de retour

Type : System.String
Représentation sous forme de chaîne de l'exception en cours.

Implémentations

_Exception.ToString()

ToString retourne une représentation explicite de l'exception en cours. Lorsque l'exception contient des données spécifiques à la culture, la représentation sous forme de chaîne retournée par ToString est requise pour prendre en compte la culture du système en cours. Il n'existe pas de format précis à respecter pour la chaîne retournée, mais il est néanmoins recommandé que celle-ci reflète la valeur de l'objet telle qu'elle est perçue par l'utilisateur.

L'implémentation par défaut de ToString obtient le nom de la classe qui a levé l'exception en cours, le message, le résultat de l'appel à ToString sur l'exception interne et le résultat de l'appel à Environment.StackTrace. Si l'un de ces membres est null, sa valeur n'est pas incluse dans la chaîne retournée.

Si aucun message d'erreur n'a été défini ou s'il s'agit d'une chaîne vide (""), aucun message d'erreur n'est retourné. Le nom de l'exception interne et la trace de la pile sont retournés uniquement s'ils ne sont pas null.

Cette méthode substitue Object.ToString.

L'exemple suivant provoque une exception et affiche le résultat de l'appel à ToString sur cette exception.

using System;

public class MyClass {}
public class ArgExceptionExample 
   {
   public static void Main()
      {
      MyClass my = new MyClass();
      string s = "sometext";
      try 
         {
         int i = s.CompareTo(my);
         }
            catch (Exception e) 
            {
            Console.WriteLine("Error: {0}",e.ToString());
            }
      }
}


import System.*;

public class MyClass
{
} //MyClass

public class ArgExceptionExample
{
    public static void main(String[] args)
    {
        MyClass my = new MyClass();
        String s = "sometext";
        try {
            int i = s.CompareTo(my);
        }
        catch (System.Exception e) {
            Console.WriteLine("Error: {0}", e.ToString());
        }
    } //main
} //ArgExceptionExample


import System;

public class MyClass {}
public class ArgExceptionExample 
   {
   public static function Main()
      {
      var my : MyClass = new MyClass();
      var s : String = "sometext";
      try 
         {
         var i : int = s.CompareTo(my);
         }
     catch (e : Exception) 
         {
         Console.WriteLine("Error: {0}",e.ToString());
         }
      }
}


Ce code génère la sortie suivante :

Error: System.ArgumentException: Object must be of type String. at System.String.CompareTo(Object value) at ArgExceptionExample.Main()

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC, Xbox 360

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Pris en charge dans : 3.5, 2.0, 1.0

XNA Framework

Pris en charge dans : 2.0, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft