Sdílet prostřednictvím

Object.ToString Metoda

  • Reference

Definice

Obor názvů:
System
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
Zdroj:
Object.cs
Zdroj:
Object.cs
Zdroj:
Object.cs

Vrátí řetězec, který představuje aktuální objekt.

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

Návraty

String

Řetězec, který představuje aktuální objekt.

Poznámky

Další informace o tomto rozhraní API najdete v tématu Doplňkové poznámky k rozhraní API pro Object.ToString.

Poznámky pro dědice

Při implementaci vlastních typů byste měli přepsat metodu ToString() , aby vrátila hodnoty, které jsou pro tyto typy smysluplné. Odvozené třídy, které vyžadují větší kontrolu nad formátováním, než ToString() poskytuje, mohou implementovat IFormattable rozhraní. Jeho ToString(String, IFormatProvider) metoda umožňuje definovat formátovací řetězce, které řídí formátování, a použít IFormatProvider objekt, který může poskytovat formátování specifické pro jazykovou verzi.

Přepsání ToString() metody by se mělo řídit těmito pokyny:

  • Vrácený řetězec by měl být přátelský a čitelný pro lidi.

  • Vrácený řetězec by měl jednoznačně identifikovat hodnotu instance objektu.

  • Vrácený řetězec by měl být co nejkratší, aby byl vhodný pro zobrazení ladicím programem.

  • Přepsání ToString() by nemělo vrátit Empty řetězec s hodnotou null.

  • Přepsání ToString() by nemělo vyvolat výjimku.

  • Pokud je řetězcová reprezentace instance citlivá na jazykovou verzi nebo může být formátována více způsoby, implementujte IFormattable rozhraní.

  • Pokud vrácený řetězec obsahuje citlivé informace, měli byste nejprve požadovat odpovídající oprávnění. Pokud poptávka uspěje, můžete citlivé informace vrátit. v opačném případě byste měli vrátit řetězec, který citlivé informace vylučuje.

  • Přepsání ToString() by nemělo mít žádné pozorovatelné vedlejší účinky, aby se zabránilo komplikacím při ladění. Například volání ToString() metody by nemělo měnit hodnotu polí instance.

  • Pokud váš typ implementuje metodu parsování (nebo ParseTryParse metodu, konstruktor nebo jinou statickou metodu, která vytvoří instanci typu z řetězce), měli byste zajistit, aby byl řetězec vrácený ToString() metodou převeden na instanci objektu.

Platí pro

Viz také