Object.ToString 方法

定义

命名空间:

System

程序集:

netstandard.dll, System.Runtime.dll

Source:

Object.cs

返回表示当前对象的字符串。

public:
 virtual System::String ^ ToString();

public virtual string? ToString();

abstract member ToString : unit -> string
override this.ToString : unit -> string

Public Overridable Function ToString () As String

返回

String

表示当前对象的字符串。

注解

有关此 API 的详细信息，请参阅 Object.ToString 的补充 API 说明。

继承者说明

实现自己的类型时，应重写 ToString() 方法以返回对这些类型有意义的值。 需要对格式设置进行更多控制而不是 ToString() 提供的派生类可以实现 IFormattable 接口。 其 ToString(String, IFormatProvider) 方法使你能够定义控制格式格式的格式字符串，并使用 IFormatProvider 可以提供区域性特定格式设置的对象。

方法的 ToString() 替代应遵循以下准则：

• 返回的字符串应该友好且可由人类读取。

• 返回的字符串应唯一标识对象实例的值。

• 返回的字符串应尽可能短，以便它适合由调试器显示。

• 重写 ToString() 不应返回 Empty 或返回 null 字符串。

• 替代 ToString() 不应引发异常。

• 如果实例的字符串表示形式区分区域性，或者可以通过多种方式设置格式，请实现 IFormattable 接口。

• 如果返回的字符串包含敏感信息，应首先要求具有适当的权限。 如果需求成功，可以返回敏感信息：否则，应返回排除敏感信息的字符串。

• 替代 ToString() 应该没有明显的副作用，以避免调试时出现复杂情况。 例如，对 方法的 ToString() 调用不应更改实例字段的值。

• 如果类型实现分析方法 (或 Parse 或 TryParse 方法、构造函数或其他静态方法（从字符串) 实例化类型的实例），则应确保方法返回的 ToString() 字符串可以转换为对象实例。

另请参阅

• 设置 .NET 中类型的格式