Object.ToString Méthode

Définition

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

public:
 virtual System::String ^ ToString();
public virtual string ToString ();
public virtual string? ToString ();
abstract member ToString : unit -> string
override this.ToString : unit -> string
Public Overridable Function ToString () As String

Retours

Chaîne qui représente l'objet actuel.

Remarques

Pour plus d’informations sur cette API, consultez Remarques supplémentaires sur l’API pour Object.ToString.

Notes pour les héritiers

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

Les remplacements de la ToString() méthode doivent suivre les instructions suivantes :

  • La chaîne retournée doit être conviviale et lisible par les humains.

  • La chaîne retournée doit identifier de manière unique la valeur de l’objet instance.

  • La chaîne retournée doit être aussi courte que possible afin qu’elle puisse être affichée par un débogueur.

  • Votre ToString() remplacement ne doit pas retourner Empty ou une chaîne null.

  • Votre ToString() remplacement ne doit pas lever d’exception.

  • Si la représentation sous forme de chaîne d’un instance respecte la culture ou peut être mise en forme de plusieurs manières, implémentez l’interfaceIFormattable.

  • Si la chaîne retournée contient des informations sensibles, vous devez d’abord demander une autorisation appropriée. Si la demande réussit, vous pouvez retourner les informations sensibles ; sinon, vous devez retourner une chaîne qui exclut les informations sensibles.

  • Votre ToString() remplacement ne doit avoir aucun effet secondaire observable pour éviter les complications lors du débogage. Par exemple, un appel à la ToString() méthode ne doit pas modifier la valeur de instance champs.

  • Si votre type implémente une méthode d’analyse (ou ParseTryParse une méthode, un constructeur ou une autre méthode statique qui instancie une instance du type à partir d’une chaîne), vous devez vous assurer que la chaîne retournée par la ToString() méthode peut être convertie en objet instance.

S’applique à

Voir aussi