Object.ToString メソッド
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在のオブジェクトを表す文字列を返します。
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()オーバーライドでは、または null 文字列を返Emptyさないでください。
ToString()オーバーライドによって例外がスローされないようにする必要があります。
インスタンスの文字列表現がカルチャに依存する場合、または複数の方法で書式設定できる場合は、 インターフェイスを実装します IFormattable 。
返される文字列に機密情報が含まれている場合は、まず適切なアクセス許可を要求する必要があります。 要求が成功した場合は、機密情報を返すことができます。それ以外の場合は、機密情報を除外する文字列を返す必要があります。
ToString()デバッグの複雑さを回避するために、オーバーライドに観察可能な副作用を含めないようにする必要があります。 たとえば、 メソッドの呼び出しで ToString() インスタンス フィールドの値を変更することはできません。
型が解析メソッド (または
Parse
TryParse
メソッド、コンストラクター、または文字列から型のインスタンスをインスタンス化するその他の静的メソッド) を実装している場合は、メソッドによってToString()返される文字列をオブジェクト インスタンスに変換できることを確認する必要があります。
製品 | バージョン |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
UWP | 10.0 |
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。