Object.ToString Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origine:
Object.cs
Origine:
Object.cs
Origine:
Object.cs

Restituisce una stringa che rappresenta l'oggetto corrente.

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

Restituisce

String

Stringa che rappresenta l'oggetto corrente.

Commenti

Per altre informazioni su questa API, vedere Note sulle API supplementari per Object.ToString.

Note per gli eredi

Quando si implementano tipi personalizzati, è necessario eseguire l'override del ToString() metodo per restituire valori significativi per tali tipi. Le classi derivate che richiedono un maggiore controllo sulla formattazione rispetto ToString() a quanto fornito possono implementare l'interfaccia IFormattable . Il metodo ToString(String, IFormatProvider) consente di definire stringhe di formato che controllano la formattazione e di usare un IFormatProvider oggetto che può fornire per la formattazione specifica delle impostazioni cultura.

Le sostituzioni del ToString() metodo devono seguire queste linee guida:

  • La stringa restituita deve essere descrittiva e leggibile dagli esseri umani.

  • La stringa restituita deve identificare in modo univoco il valore dell'istanza dell'oggetto.

  • La stringa restituita deve essere il più breve possibile in modo che sia adatta per la visualizzazione da parte di un debugger.

  • L'override ToString() non deve restituire Empty o una stringa Null.

  • L'override ToString() non deve generare un'eccezione.

  • Se la rappresentazione di stringa di un'istanza è sensibile alle impostazioni cultura o può essere formattata in diversi modi, implementare l'interfaccia IFormattable .

  • Se la stringa restituita include informazioni riservate, è prima necessario richiedere un'autorizzazione appropriata. Se la richiesta ha esito positivo, è possibile restituire le informazioni riservate; in caso contrario, è necessario restituire una stringa che esclude le informazioni riservate.

  • L'override ToString() non deve avere effetti collaterali osservabili per evitare complicazioni nel debug. Ad esempio, una chiamata al ToString() metodo non deve modificare il valore dei campi dell'istanza.

  • Se il tipo implementa un metodo di analisi (o Parse o TryParse , un costruttore o un altro metodo statico che crea un'istanza del tipo da una stringa), è necessario assicurarsi che la stringa restituita dal ToString() metodo possa essere convertita in un'istanza dell'oggetto .

Si applica a

Vedi anche