Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source

Object.ToString, méthode

Retourne une chaîne qui représente l'objet actuel.

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

public virtual string ToString()

Valeur de retour

Type : System.String
Chaîne qui représente l'objet en cours.

ToString est la méthode de mise en forme majeure dans le .NET Framework. Elle convertit un objet au format de chaîne de caractères afin qu'il soit affichable. 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


Remarques à l'attention des implémenteurs

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

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

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Pris en charge dans :

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

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

Date

Historique

Motif

Mars 2011

Nombreuses modifications.

Commentaires client.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2015 Microsoft