Object.ToString 方法

定義

命名空間:

System

組件:

netstandard.dll, System.Runtime.dll

來源:

Object.cs

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

C#

public virtual string? ToString();

傳回

String

表示目前物件的字串。

備註

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

給繼承者的注意事項

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

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

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

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

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

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

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

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

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

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

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

適用於

另請參閱

• 在 .NET 中將類型格式化