System.Object.ToString 方法
方法描述
返回表示当前对象的字符串。
语法定义(C# System.Object.ToString 方法 的用法)
public virtual string ToString()
参数/返回值
参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
---|---|---|
返回值 | System.String | 表示当前对象的字符串。 |
提示和注释
ToString 是 .NET Framework 中主要的格式化方法。 它将对象转换为其字符串表现形式,使它适合于显示。 (有关对 .NET Framework 中的格式设置支持的更多信息,请参见 格式化类型。)
ToString 方法的默认实现返回 Object 的类型的完全限定名,如以下示例所示。
C#
VB
复制
using System;
public class Example
{
public static void Main()
{
Object obj = new Object();
Console.WriteLine(obj.ToString());
}
}
// The example displays the following output:
// System.Object
因为 Object 是在 .NET Framework 中所有引用类型的基类,所以这种行为由不重写 ToString 方法的引用类型继承。 下面的示例阐释了这一点。 它定义了名为 Object1 的类,用来接受所有 Object 成员的默认实现。 其 ToString 方法返回该对象的完全限定类型名。
C#
VB
复制
using System;
using Examples;
namespace Examples
{
public class Object1
{
}
}
public class Example
{
public static void Main()
{
object obj1 = new Object1();
Console.WriteLine(obj1.ToString());
}
}
// The example displays the following output:
// Examples.Object1
类型通常覆盖 ToString 方法以返回表示对象实例的字符串。 例如,基础数据类型(如 Char, Int32和 String)提供 ToString 实现该返回对象表示的值的字符串形式。 下面的示例定义一个为 Object2 的类,该类重写 ToString 方法以返回类型名称以及其值。
C#
VB
复制
using System;
public class Object2
{
private object value;
public Object2(object value)
{
this.value = value;
}
public override string ToString()
{
return base.ToString() + ": " + value.ToString();
}
}
public class Example
{
public static void Main()
{
Object2 obj2 = new Object2('a');
Console.WriteLine(obj2.ToString());
}
}
// The example displays the following output:
// Object2: a
对实现者的说明
当实现您自己的类型时,应重写 ToString 方法,以返回对这些类型有意义的值。 需要比 ToString 提供的对格式设置的控制更多控制的派生类应实现 IFormattable 接口。 其 IFormattable.ToString(String, IFormatProvider) 方法使您能够定义控制格式设置的格式字符串,并使用可以为区域性特定的格式设置提供的 IFormatProvider 对象。
System.Object.ToString 方法例子
版本信息
.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1 受以下版本支持:
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。