Object.ToString メソッド

リファレンス

定義

名前空間:: System

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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

戻り値

String

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

注釈

Object.ToStringは、.NET Frameworkの主要な書式設定方法です。表示に適したオブジェクトを文字列表現に変換します。 (.NET Frameworkでの書式設定のサポートについては、「型の書式設定」を参照してください)。メソッドの既定のObject.ToString実装では、オブジェクトの型の完全修飾名が返されます。

重要

別の種類のメンバーリストのリンクに従って、このページに到達した可能性があります。これは、その型がオーバーライド Object.ToStringされないためです。代わりに、メソッドの機能を Object.ToString 継承します。

型は、特定の型の Object.ToString より適切な文字列表現を提供するために、頻繁にメソッドをオーバーライドします。型は、書式指定文字列やカルチャに依存する Object.ToString 書式設定をサポートするために、メソッドをオーバーロードする場合もよくあります。

このセクションの内容は次のとおりです。

既定の Object.ToString() メソッド
 Object.ToString() メソッドのオーバーライド
 ToString メソッドのオーバーロード
 Object.ToString メソッドの拡張
 Windows ランタイムに関する注意事項

既定の Object.ToString() メソッド

メソッドの既定の ToString 実装では、次の例に示すように、型の Object完全修飾名が返されます。

using namespace System;

void main()
{
   Object^ obj = gcnew Object();
   Console::WriteLine(obj->ToString());
}
// The example displays the following output:
//      System.Object

Object obj = new Object();
Console.WriteLine(obj.ToString());

// The example displays the following output:
//      System.Object

let obj = obj ()
printfn $"{obj.ToString()}"
// printfn $"{obj}" // Equivalent

// The example displays the following output:
//      System.Object

Module Example
   Public Sub Main()
      Dim obj As New Object()
      Console.WriteLine(obj.ToString())
   End Sub
End Module
' The example displays the following output:
'      System.Object

.NET Framework内のすべての参照型の基底クラスであるためObject、この動作は、メソッドをオーバーライドToStringしない参照型によって継承されます。次の例を使って説明します。すべてのObjectメンバーの既定の実装を受け入れる名前Object1のクラスを定義します。そのメソッドは ToString 、オブジェクトの完全修飾型名を返します。

using namespace System;

namespace Examples
{
   ref class Object1
   {
   };
}

void main()
{
   Object^ obj1 = gcnew Examples::Object1();
   Console::WriteLine(obj1->ToString());
}
// The example displays the following output:
//   Examples.Object1

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

type Object1() = class end

let obj1 = Object1()
printfn $"{obj1.ToString()}"
// The example displays the following output:
//   Examples.Object1

Imports Examples

Namespace Examples
   Public Class Object1
   End Class
End Namespace

Module Example
   Public Sub Main()
      Dim obj1 As New Object1()
      Console.WriteLine(obj1.ToString())
   End Sub
End Module
' The example displays the following output:
'   Examples.Object1

Object.ToString() メソッドのオーバーライド

型は、通常、オブジェクトインスタンスを Object.ToString 表す文字列を返すメソッドをオーバーライドします。たとえば、オブジェクトが表す値の文字列形式を返す、などの基本型Char Int32とString実装を提供ToStringします。次の例では、 Object2型名とその値を返すメソッドを ToString オーバーライドするクラスを定義します。

using namespace System;

ref class Object2
{
   private:
      Object^ value;

   public:
      Object2(Object^ value)
      {
         this->value = value;
      }

      virtual String^ ToString() override
      {
         return Object::ToString() + ": " + value->ToString();
      }
};

void main()
{
   Object2^ obj2 = gcnew Object2(L'a');
   Console::WriteLine(obj2->ToString());
 
}
// The example displays the following output:
//       Object2: a

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

type Object2(value: obj) =
    inherit obj ()
    override _.ToString() =
        base.ToString() + ": " + value.ToString()

let obj2 = Object2 'a'
printfn $"{obj2.ToString()}"
// The example displays the following output:
//       Object2: a

Public Class Object2
   Private value As Object
   
   Public Sub New(value As Object)
      Me.value = value
   End Sub
   
   Public Overrides Function ToString() As String
      Return MyBase.ToString + ": " + value.ToString()
   End Function
End Class

Module Example
   Public Sub Main()
      Dim obj2 As New Object2("a"c)
      Console.WriteLine(obj2.ToString())
   End Sub
End Module
' The example displays the following output:
'       Object2: a

次の表に、.NET の型カテゴリを示し、メソッドをオーバーライド Object.ToString するかどうかを示します。

型のカテゴリ	Object.ToString() をオーバーライドします。	動作
クラス	該当なし	該当なし
構造	はい (ValueType.ToString)	`Object.ToString()` と同じ
列挙	はい (Enum.ToString())	メンバー名
Interface	いいえ	該当なし
Delegate	いいえ	該当なし

オーバーライドの詳細については、「継承者へのメモ」セクションを ToString参照してください。

ToString メソッドのオーバーロード

パラメーターなしの Object.ToString() メソッドをオーバーライドするだけでなく、多くの型がメソッドを ToString オーバーロードして、パラメーターを受け入れるメソッドのバージョンを提供します。最も一般的に、これは、変数の書式設定とカルチャに依存する書式設定のサポートを提供するために行われます。

次の例では、 ToString クラスのさまざまなフィールドの値を含む結果文字列を返すメソッドを Automobile オーバーロードします。これは、モデル名と年を返す G という 4 つの書式指定文字列を定義します。D: モデル名、年、ドア数を返します。モデル名、年、およびシリンダー数を返す C。および A。4 つのフィールド値をすべて含む文字列を返します。

using System;

public class Automobile
{
   private int _doors;
   private string _cylinders;
   private int _year;
   private string _model;

   public Automobile(string model, int year , int doors,
                     string cylinders)
   {
      _model = model;
      _year = year;
      _doors = doors;
      _cylinders = cylinders;
   }

   public int Doors
   { get { return _doors; } }

   public string Model
   { get { return _model; } }

   public int Year
   { get { return _year; } }

   public string Cylinders
   { get { return _cylinders; } }

   public override string ToString()
   {
      return ToString("G");
   }

   public string ToString(string fmt)
   {
      if (string.IsNullOrEmpty(fmt))
         fmt = "G";

      switch (fmt.ToUpperInvariant())
      {
         case "G":
            return string.Format("{0} {1}", _year, _model);
         case "D":
            return string.Format("{0} {1}, {2} dr.",
                                 _year, _model, _doors);
         case "C":
            return string.Format("{0} {1}, {2}",
                                 _year, _model, _cylinders);
         case "A":
            return string.Format("{0} {1}, {2} dr. {3}",
                                 _year, _model, _doors, _cylinders);
         default:
            string msg = string.Format("'{0}' is an invalid format string",
                                       fmt);
            throw new ArgumentException(msg);
      }
   }
}

public class Example
{
   public static void Main()
   {
      var auto = new Automobile("Lynx", 2016, 4, "V8");
      Console.WriteLine(auto.ToString());
      Console.WriteLine(auto.ToString("A"));
   }
}
// The example displays the following output:
//       2016 Lynx
//       2016 Lynx, 4 dr. V8

open System

type Automobile(model: string, year: int, doors: int, cylinders: string) =
    member _.Doors = doors
    member _.Model = model
    member _.Year = year
    member _.Cylinders = cylinders

    override this.ToString() =
        this.ToString "G"

    member _.ToString(fmt) =
        let fmt = 
            if String.IsNullOrEmpty fmt then "G"
            else fmt.ToUpperInvariant()

        match fmt with
        | "G" ->
            $"{year} {model}"
        | "D" ->
            $"{year} {model}, {doors} dr."
        | "C" ->
            $"{year} {model}, {cylinders}"
        | "A" ->
            $"{year} {model}, {doors} dr. {cylinders}"
        | _ ->
            raise (ArgumentException $"'{fmt}' is an invalid format string")

let auto = Automobile("Lynx", 2016, 4, "V8")
printfn $"{auto}"
printfn $"""{auto.ToString "A"}"""
// The example displays the following output:
//       2016 Lynx
//       2016 Lynx, 4 dr. V8

Public Class Automobile
   Private _doors As Integer
   Private _cylinders As String
   Private _year As Integer
   Private _model As String
   
   Public Sub New(model As String, year As Integer, doors As Integer,
                  cylinders As String)
      _model = model
      _year = year
      _doors = doors
      _cylinders = cylinders
   End Sub
   
   Public ReadOnly Property Doors As Integer
      Get
          Return _doors
      End Get
   End Property
   
   Public ReadOnly Property Model As String
      Get
         Return _model
      End Get
   End Property
   
   Public ReadOnly Property Year As Integer
      Get
         Return _year
      End Get
   End Property
   
   Public ReadOnly Property Cylinders As String
      Get
         Return _cylinders
      End Get
   End Property
   
   Public Overrides Function ToString() As String
      Return ToString("G")
   End Function
   
   Public Overloads Function ToString(fmt As String) As String
      If String.IsNullOrEmpty(fmt) Then fmt = "G"
      
      Select Case fmt.ToUpperInvariant()
         Case "G"
            Return String.Format("{0} {1}", _year, _model)
         Case "D"
            Return String.Format("{0} {1}, {2} dr.",
                                 _year, _model, _doors)
         Case "C"
            Return String.Format("{0} {1}, {2}",
                                 _year, _model, _cylinders)
         Case "A"
            Return String.Format("{0} {1}, {2} dr. {3}",
                                 _year, _model, _doors, _cylinders)
         Case Else
            Dim msg As String = String.Format("'{0}' is an invalid format string",
                                              fmt)
            Throw New ArgumentException(msg)
      End Select
   End Function
End Class

Module Example
   Public Sub Main()
      Dim auto As New Automobile("Lynx", 2016, 4, "V8")
      Console.WriteLine(auto.ToString())
      Console.WriteLine(auto.ToString("A"))
   End Sub
End Module
' The example displays the following output:
'       2016 Lynx
'       2016 Lynx, 4 dr. V8

次の例では、オーバーロードされた Decimal.ToString(String, IFormatProvider) メソッドを呼び出して、通貨値のカルチャに依存する書式を表示します。

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] cultureNames = { "en-US", "en-GB", "fr-FR",
                                "hr-HR", "ja-JP" };
      Decimal value = 1603.49m;
      foreach (var cultureName in cultureNames) {
         CultureInfo culture = new CultureInfo(cultureName);
         Console.WriteLine("{0}: {1}", culture.Name,
                           value.ToString("C2", culture));
      }
   }
}
// The example displays the following output:
//       en-US: $1,603.49
//       en-GB: £1,603.49
//       fr-FR: 1 603,49 €
//       hr-HR: 1.603,49 kn
//       ja-JP: ¥1,603.49

open System.Globalization

let cultureNames =
    [| "en-US"; "en-GB"; "fr-FR"; "hr-HR"; "ja-JP" |]
let value = 1603.49m
for cultureName in cultureNames do
    let culture = CultureInfo cultureName
    printfn $"""{culture.Name}: {value.ToString("C2", culture)}"""
// The example displays the following output:
//       en-US: $1,603.49
//       en-GB: £1,603.49
//       fr-FR: 1 603,49 €
//       hr-HR: 1.603,49 kn
//       ja-JP: ¥1,603.49

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim cultureNames() As String = { "en-US", "en-GB", "fr-FR",
                                       "hr-HR", "ja-JP" }
      Dim value As Decimal = 1603.49d
      For Each cultureName In cultureNames
         Dim culture As New CultureInfo(cultureName)
         Console.WriteLine("{0}: {1}", culture.Name,
                           value.ToString("C2", culture))
      Next
   End Sub
End Module
' The example displays the following output:
'       en-US: $1,603.49
'       en-GB: £1,603.49
'       fr-FR: 1 603,49 €
'       hr-HR: 1.603,49 kn
'       ja-JP: ¥1,603.49

書式指定文字列とカルチャに依存する書式の詳細については、「型の書式設定」を参照してください。数値でサポートされる書式指定文字列については、「標準の数値書式指定文字列」および「カスタム数値書式指定文字列」を参照してください。日付と時刻の値でサポートされる書式指定文字列については、「標準の日時書式指定文字列」および「カスタム日時書式指定文字列」を参照してください。

Object.ToString メソッドの拡張

型は既定 Object.ToString のメソッドを継承するため、その動作が望ましくない場合があり、変更する必要があります。これは、配列とコレクションクラスに特に当てはまります。配列またはコレクションクラスのメソッドでは、そのメンバーの値が表示されると想定 ToString できますが、次の例に示すように、型の完全修飾型名が表示されます。

int[] values = { 1, 2, 4, 8, 16, 32, 64, 128 };
Console.WriteLine(values.ToString());

List<int> list = new List<int>(values);
Console.WriteLine(list.ToString());

// The example displays the following output:
//       System.Int32[]
//       System.Collections.Generic.List`1[System.Int32]

let values = [| 1; 2; 4; 8; 16; 32; 64; 128 |]
printfn $"{values}"

let list = ResizeArray values
printfn $"{list}"

// The example displays the following output:
//       System.Int32[]
//       System.Collections.Generic.List`1[System.Int32]

Imports System.Collections.Generic

Module Example
   Public Sub Main()
      Dim values() As Integer = { 1, 2, 4, 8, 16, 32, 64, 128 }
      Console.WriteLine(values.ToString())
      
      Dim list As New List(Of Integer)(values)
      Console.WriteLine(list.ToString())
   End Sub
End Module
' The example displays the following output:
'    System.Int32[]
'    System.Collections.Generic.List`1[System.Int32]

必要な結果文字列を生成するには、いくつかのオプションがあります。

型が配列、コレクションオブジェクト、またはインターフェイスを実装IEnumerableするオブジェクトの場合は、C# のステートメントまたは IEnumerable<T> Visual Basic 内のコンストラクトを使用してforeach、その要素をFor Each...Next列挙できます。

クラスが (C#の場合) または NotInheritable (Visual Basic) でないsealed場合は、カスタマイズするメソッドを持つObject.ToString基底クラスから継承するラッパークラスを開発できます。少なくとも、これには次の操作が必要です。

必要なコンストラクターを実装します。派生クラスは、基底クラスのコンストラクターを継承しません。
メソッドを Object.ToString オーバーライドして、必要な結果文字列を返します。

次の例では、クラスのラッパークラスを List<T> 定義します。完全修飾型名ではなく、コレクションの各メソッドの値を表示するメソッドをオーバーライド Object.ToString します。

using System;
using System.Collections.Generic;

public class CList<T> : List<T>
{
   public CList(IEnumerable<T> collection) : base(collection)
   { }

   public CList() : base()
   {}

   public override string ToString()
   {
      string retVal = string.Empty;
      foreach (T item in this) {
         if (string.IsNullOrEmpty(retVal))
            retVal += item.ToString();
         else
            retVal += string.Format(", {0}", item);
      }
      return retVal;
   }
}

public class Example
{
   public static void Main()
   {
      var list2 = new CList<int>();
      list2.Add(1000);
      list2.Add(2000);
      Console.WriteLine(list2.ToString());
   }
}
// The example displays the following output:
//    1000, 2000

open System
open System.Collections.Generic

type CList<'T>() = 
    inherit ResizeArray<'T>()
    
    override this.ToString() =
        let mutable retVal = String.Empty
        for item in this do
            if String.IsNullOrEmpty retVal then
                retVal <- retVal + string item
            else
                retVal <- retVal + $", {item}"
        retVal

let list2 = CList()
list2.Add 1000
list2.Add 2000
printfn $"{list2}"
// The example displays the following output:
//    1000, 2000

Imports System.Collections.Generic

Public Class CList(Of T) : Inherits List(Of T)
   Public Sub New(capacity As Integer)
      MyBase.New(capacity)
   End Sub

   Public Sub New(collection As IEnumerable(Of T))
      MyBase.New(collection)
   End Sub

   Public Sub New()
      MyBase.New()
   End Sub

   Public Overrides Function ToString() As String
      Dim retVal As String = String.Empty
      For Each item As T In Me
         If String.IsNullOrEmpty(retval) Then
            retVal += item.ToString()
         Else
            retval += String.Format(", {0}", item)
         End If
      Next
      Return retVal
   End Function
End Class

Module Example
   Public Sub Main()
      Dim list2 As New CList(Of Integer)
      list2.Add(1000)
      list2.Add(2000)
      Console.WriteLine(list2.ToString())
   End Sub
End Module
' The example displays the following output:
'       1000, 2000

目的の結果文字列を返す拡張メソッドを開発します。この方法では、既定Object.ToStringのメソッドをオーバーライドできないことに注意してください (つまり、拡張クラス (C#の場合) またはモジュール (Visual Basic) には、元の型ToStringのメソッドの代わりに呼び出されるパラメーターToStringなしのメソッドを指定することはできません。パラメーターなしの ToString 置換には、他の名前を指定する必要があります。

次の例では、クラスを拡張 List<T> する 2 つのメソッドを定義します。パラメーターなしの ToString2 メソッドと ToString 、書式指定文字列を String 表すパラメーターを持つメソッドです。

using System;
using System.Collections.Generic;

public static class StringExtensions
{
   public static string ToString2<T>(this List<T> l)
   {
      string retVal = string.Empty;
      foreach (T item in l)
         retVal += string.Format("{0}{1}", string.IsNullOrEmpty(retVal) ?
                                                     "" : ", ",
                                  item);
      return string.IsNullOrEmpty(retVal) ? "{}" : "{ " + retVal + " }";
   }

   public static string ToString<T>(this List<T> l, string fmt)
   {
      string retVal = string.Empty;
      foreach (T item in l) {
         IFormattable ifmt = item as IFormattable;
         if (ifmt != null)
            retVal += string.Format("{0}{1}",
                                    string.IsNullOrEmpty(retVal) ?
                                       "" : ", ", ifmt.ToString(fmt, null));
         else
            retVal += ToString2(l);
      }
      return string.IsNullOrEmpty(retVal) ? "{}" : "{ " + retVal + " }";
   }
}

public class Example
{
   public static void Main()
   {
      List<int> list = new List<int>();
      list.Add(1000);
      list.Add(2000);
      Console.WriteLine(list.ToString2());
      Console.WriteLine(list.ToString("N0"));
   }
}
// The example displays the following output:
//       { 1000, 2000 }
//       { 1,000, 2,000 }

open System
open System.Collections.Generic

type List<'T> with
    member this.ToString2<'T>() = 
        let mutable retVal = String.Empty
        for item in this do
           retVal <- retVal + $"""{if String.IsNullOrEmpty retVal then "" else ", "}{item}"""
        if String.IsNullOrEmpty retVal then "{}" else "{ " + retVal + " }"

    member this.ToString<'T>(fmt: string) =
        let mutable retVal = String.Empty
        for item in this do
            match box item with
            | :? IFormattable as ifmt ->
                retVal <- retVal + $"""{if String.IsNullOrEmpty retVal then "" else ", "}{ifmt.ToString(fmt, null)}"""
            | _ ->
                retVal <- retVal + this.ToString2()
        if String.IsNullOrEmpty retVal then "{}" else "{ " + retVal + " }"

let list = ResizeArray()
list.Add 1000
list.Add 2000
printfn $"{list.ToString2()}"
printfn $"""{list.ToString "N0"}"""
// The example displays the following output:
//       { 1000, 2000 }
//       { 1,000, 2,000 }

Imports System.Collections.Generic
Imports System.Runtime.CompilerServices

Public Module StringExtensions
   <Extension()>
   Public Function ToString2(Of T)(l As List(Of T)) As String
      Dim retVal As String = ""
      For Each item As T In l
         retVal += String.Format("{0}{1}", If(String.IsNullOrEmpty(retVal),
                                                     "", ", "),
                                  item)
      Next
      Return If(String.IsNullOrEmpty(retVal), "{}", "{ " + retVal + " }")
   End Function

   <Extension()>
   Public Function ToString(Of T)(l As List(Of T), fmt As String) As String
      Dim retVal As String = String.Empty
      For Each item In l
         Dim ifmt As IFormattable = TryCast(item, IFormattable)
         If ifmt IsNot Nothing Then
            retVal += String.Format("{0}{1}",
                                    If(String.IsNullOrEmpty(retval),
                                       "", ", "), ifmt.ToString(fmt, Nothing))
         Else
            retVal += ToString2(l)
         End If
      Next
      Return If(String.IsNullOrEmpty(retVal), "{}", "{ " + retVal + " }")
   End Function
End Module

Module Example
   Public Sub Main()
      Dim list As New List(Of Integer)
      list.Add(1000)
      list.Add(2000)
      Console.WriteLine(list.ToString2())
      Console.WriteLine(list.ToString("N0"))
   End Sub
End Module
' The example displays the following output:
'       { 1000, 2000 }
'       { 1,000, 2,000 }

Windows ランタイムに関する注意事項

Windows ランタイム内のToStringクラスでメソッドを呼び出すと、オーバーライドToStringされないクラスの既定の動作が提供されます。これは、.NET FrameworkがWindows ランタイムに提供するサポートの一部です (Windows ストアアプリとWindows ランタイムのサポート.NET Framework参照)。 Windows ランタイム内のクラスは継承Objectせず、常に .ToString ただし、C# または Visual Basic コードで使用すると、常にメソッドが含まれているように見えToString Equals(Object)GetHashCode、.NET Frameworkはこれらのメソッドの既定の動作を提供します。

.NET Framework 4.5.1 以降では、共通言語ランタイムは、既定の実装Object.ToStringにフォールバックする前に、Windows ランタイムオブジェクトで IStringable.ToString を使用します。

注意

C# または Visual Basic で記述されたクラスWindows ランタイム、メソッドをToStringオーバーライドできます。

Windows ランタイムと IStringable インターフェイス

Windows 8.1以降、Windows ランタイムには IStringable インターフェイスが含まれています。その 1 つのメソッドである IStringable.ToString では、提供されているのと同等の基本的な書式設定のサポートが提供されますObject.ToString。あいまいさを防ぐために、マネージド型に IStringable を実装しないでください。

マネージドオブジェクトは、ネイティブコードまたは JavaScript や C++/CX などの言語で記述されたコードによって呼び出されると、 IStringable を実装するように見えます。共通言語ランタイムは、IStringable.ToString からマネージドオブジェクトに IStringable が実装されていない場合にObject.ToString呼び出しを自動的にルーティングします。

警告

共通言語ランタイムでは、Windows ストアアプリ内のすべてのマネージド型に IStringable が自動的に実装されるため、独自IStringableの実装は提供しないことをお勧めします。実装IStringableすると、Windows ランタイム、C++/CX、または JavaScript から呼び出ToStringすときに意図しない動作が発生する可能性があります。

Windows ランタイムコンポーネントにエクスポートされるパブリックマネージド型に IStringable を実装する場合は、次の制限が適用されます。

IStringable インターフェイスは、次のように "クラス実装" リレーションシップでのみ定義できます。
```
public class NewClass : IStringable
```
```
Public Class NewClass : Implements IStringable
```
インターフェイスに IStringable を実装することはできません。
パラメーターを IStringable 型として宣言することはできません。
IStringable は、メソッド、プロパティ、またはフィールドの戻り値の型にすることはできません。
次のようなメソッド定義を使用して、基底クラスから IStringable 実装を非表示にすることはできません。
```
public class NewClass : IStringable  
{  
   public new string ToString()  
   {  
      return "New ToString in NewClass";  
   }  
}  
```
代わりに、IStringable.ToString の実装で基底クラスの実装を常にオーバーライドする必要があります。 ToString の実装を隠すことができるのは、厳密に型指定されたクラスインスタンスで呼び出す場合だけです。

さまざまな条件下で、ネイティブコードから IStringable を実装するマネージド型への呼び出し、または ToString 実装を非表示にするマネージド型の呼び出しでは、予期しない動作が発生する可能性があることに注意してください。

注意 (継承者)

独自の型を実装する場合は、メソッドを ToString() オーバーライドして、それらの型にとって意味のある値を返す必要があります。提供されるより ToString() 多くの書式を制御する必要がある派生クラスは、インターフェイスを IFormattable 実装できます。その ToString(String, IFormatProvider) メソッドを使用すると、書式設定を制御する書式指定文字列を定義し、カルチャ固有の書式設定を IFormatProvider 提供できるオブジェクトを使用できます。

メソッドのオーバーライドは、 ToString() 次のガイドラインに従う必要があります。

返される文字列は、人間がわかりやすい読み取り可能にする必要があります。
返される文字列は、オブジェクトインスタンスの値を一意に識別する必要があります。
返される文字列は、デバッガーによる表示に適した短い文字列にする必要があります。

ToString()- オーバーライドは返されないか、null 文字列を返Emptyす必要があります。

ToString()- オーバーライドによって例外がスローされないようにする必要があります。

インスタンスの文字列表現がカルチャに依存しているか、複数の方法で書式設定できる場合は、インターフェイスを IFormattable 実装します。
返される文字列に機密情報が含まれている場合は、まず適切なアクセス許可を要求する必要があります。要求が成功した場合は、機密情報を返すことができます。それ以外の場合は、機密情報を除外する文字列を返す必要があります。

ToString()- デバッグの複雑化を回避するために、オーバーライドに観察可能な副作用を含めないようにする必要があります。たとえば、メソッドの呼び出しでは ToString() 、インスタンスフィールドの値を変更しないでください。

型が解析メソッド (またはParseTryParseメソッド、コンストラクター、または文字列から型のインスタンスをインスタンス化する他の静的メソッド) を実装している場合は、メソッドによってToString()返される文字列をオブジェクトインスタンスに変換できるようにする必要があります。

適用対象

こちらもご覧ください

.NET での型の書式設定