Object.ToString, méthode

ToString est la méthode de mise en forme majeure dans le .NET Framework. Il convertit un objet dans sa représentation de chaîne afin qu'il soit approprié pour l'affichage. Pour plus d'informations sur la prise en charge de la mise en forme dans le .NET Framework, consultez Mise en forme des types.

L'implémentation par défaut de la méthode ToString retourne le nom qualifié complet du type du Object, comme l'illustre l'exemple suivant.

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

Étant donné que Object est la classe de base de tous les types référence dans le .NET Framework, ce comportement est hérité par les types référence qui ne substituent pas la méthode ToString. L'exemple suivant illustre ce comportement. Il définit une classe nommée Object1 qui accepte l'implémentation par défaut de tous les membres Object. Sa méthode ToString retourne le nom de type qualifié complet de l'objet.

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

Généralement, les types remplacent la méthode ToString pour retourner une chaîne qui représente l'instance de l'objet. Par exemple, les types de données de base, tels que Char, Int32 et String implémentent ToString de sorte qu'il retourne la forme de chaîne de la valeur représentée par l'objet. L'exemple suivant définit une classe, Object2, qui remplace la méthode ToString pour retourner le nom de type avec sa valeur.

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

Lorsque vous implémentez vos propres types, vous devez substituer la méthode ToString aux valeurs de retour qui sont explicites pour ces types. Les classes dérivées qui requièrent plus de contrôle sur la mise en forme que ne fournit ToString peuvent implémenter l'interface IFormattable. Sa méthode IFormattable.ToString(String, IFormatProvider) vous permet de définir des chaînes de format qui contrôlent la mise en forme et utiliser un objet IFormatProvider qui peut fournir la mise en forme spécifique à la culture.

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Référence

Autres ressources