Object.ToString Metoda

Definice

Obor názvů:
System
Sestavení:
mscorlib.dll, System.Runtime.dll
Sestavení:
netstandard.dll, System.Runtime.dll
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
Zdroj:
Object.cs
Zdroj:
Object.cs
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 naleznete 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() tak, aby vracela 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žívat IFormatProvider objekt, který může poskytovat formátování specifické pro jazykovou verzi.

Přepsání ToString() metody by mělo postupovat podle těchto pokynů:

  • Vrácený řetězec by měl být srozumitelný a čitelný lidmi.

  • 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 vracet Empty ani řetězec null.

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

  • Pokud je řetězcová reprezentace instance citlivá na jazykovou verzi nebo je možné ji naformátovat několika způsoby, implementujte IFormattable rozhraní.

  • Pokud vrácený řetězec obsahuje citlivé informace, měli byste nejprve požádat o odpovídající oprávnění. Pokud poptávka proběhne úspěšně, můžete vrátit citlivé informace; jinak byste měli vrátit řetězec, který vyloučí citlivé informace.

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

  • Pokud váš typ implementuje metodu analýzy (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é