Object.ToString Méthode

Définition

Espace de noms:
System
Assemblys:
mscorlib.dll, System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll

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

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

Retours

String

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

Remarques

Pour plus d’informations sur cette API, consultez les remarques d’API supplémentaires 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() les 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 IFormatProvider objet qui peut fournir une 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’instance d’objet.

  • La chaîne retournée doit être aussi courte que possible afin qu’elle soit adaptée à l’affichage 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’une instance respecte la culture ou peut être mise en forme de plusieurs façons, implémentez l’interface IFormattable .

  • Si la chaîne retournée inclut 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 pas avoir d’effets secondaires observables pour éviter les complications dans le débogage. Par exemple, un appel à la ToString() méthode ne doit pas modifier la valeur des champs d’instance.

  • 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 instance d’objet.

S’applique à

Voir aussi