Object.ToString 方法

定義

傳回代表目前物件的字串。

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

傳回

表示目前物件的字串。

備註

如需此 API 的詳細資訊,請參閱 Object.ToString 的補充 API 備註

給繼承者的注意事項

當您實作自己的類型時,您應該覆寫 ToString() 方法,以傳回這些類型有意義的值。 需要更充分控制格式設定的衍生類別,比 ToString() 提供的 可以實作 IFormattable 介面。 其 ToString(String, IFormatProvider) 方法可讓您定義可控制格式設定的格式字串,以及使用 IFormatProvider 可為特定文化特性格式設定提供的物件。

方法的 ToString() 覆寫應遵循下列指導方針:

  • 傳回的字串應該是人類易記且可讀的。

  • 傳回的字串應該可唯一識別物件實例的值。

  • 傳回的字串應該盡可能短,以便調試程式適合顯示。

  • 您的 ToString() 覆寫不應該傳回 Empty 或 Null 字串。

  • 您的 ToString() 覆寫不應該擲回例外狀況。

  • 如果實例的字串表示區分文化特性,或可以多種方式格式化,請實作 IFormattable 介面。

  • 如果傳回的字串包含敏感性資訊,您應該先要求適當的許可權。 如果需求成功,您可以傳回敏感性資訊;否則,您應該傳回排除敏感性資訊的字串。

  • 您的 ToString() 覆寫應該沒有任何可觀察的副作用,以避免偵錯時發生複雜問題。 例如,對方法的 ToString() 呼叫不應該變更實例欄位的值。

  • 如果您的型別實作剖析方法 (或 或 ParseTryParse 方法、建構函式或其他靜態方法,以從字串) 具現化型別的實例,您應該確定方法傳 ToString() 回的字串可以轉換成對象實例。

適用於

另請參閱