Comment : substituer la méthode ToString (Guide de programmation C#)

Mise à jour : novembre 2007

Chaque objet en C# hérite de la méthode ToString, qui retourne une représentation de chaîne de cet objet. Par exemple, toutes les variables de type int ont une méthode ToString qui leur permet de retourner leur contenu sous la forme d'une chaîne :

int x = 42;
string strx = x.ToString();
System.Console.WriteLine(strx);

Lorsque vous créez une classe ou une structure personnalisée, vous devez substituer la méthode ToString afin de fournir des informations sur votre type au code client.

Note de sécurité :
Lors du choix des informations à fournir via cette méthode, demandez-vous si votre classe ou structure risque d'être utilisée par un code non fiable. Veillez à vous assurer que vous ne fournissez aucune information qui pourrait être exploitée par un code malveillant.

Pour substituer la méthode OnString dans votre classe ou structure

1. Déclarez une méthode ToString avec les modificateurs et le type de retour suivants :

   public override string ToString(){}
   

2. Implémentez la méthode de telle sorte qu'elle retourne une chaîne.

   L'exemple suivant retourne non seulement le nom de la classe, mais également les données spécifiques à une instance particulière de la classe. Notez qu'il utilise également la méthode ToString sur la variable age pour convertir l'int en une chaîne qui puisse être sortie.

   class Person
   { 
     string name;
     int age;
     SampleObject(string name, int age)
     {
     this.name = name;
     this.age = age;
     }
     public override string ToString() 
     {
        string s = age.ToString();
        return "Person: " + name + " " + s;
     }
   }
   

Voir aussi

Concepts

Guide de programmation C#

Référence

Classes et structs (Guide de programmation C#)

new (Référence C#)

override (Référence C#)

virtual (Référence C#)