Object.ToString メソッド

定義

名前空間:
System
アセンブリ:
mscorlib.dll, System.Runtime.dll
アセンブリ:
mscorlib.dll
アセンブリ:
System.Runtime.dll
アセンブリ:
netstandard.dll

現在のオブジェクトを表す文字列を返します。

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() メソッドによって返される文字列をオブジェクト インスタンスに変換できるようにする必要があります。

適用対象

こちらもご覧ください