Object.ToString メソッド

2013/12/12

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

Namespace:  System
アセンブリ:  mscorlib (mscorlib.dll 内)

'宣言
Public Overridable Function ToString As String

戻り値

型: System.String
現在のオブジェクトを表す文字列。

ToString は、.NET Framework における主要な書式指定メソッドです。表示用にオブジェクトを文字列表現に変換します。(.NET Framework の書式指定のサポートの詳細については、「[0d1364da-5b30-4d42-8e6b-03378343343f]」を参照してください。)

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


Module Example
   Public Sub Demo(outputBlock As System.Windows.Controls.TextBlock)
      Dim obj As New Object()
      outputBlock.Text += obj.ToString()
   End Sub
End Module
' The example displays the following output:
'      System.Object


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


Namespace Examples
   Public Class Object1
   End Class
End Namespace

Module Example
   Public Sub Demo(outputBlock As System.Windows.Controls.TextBlock)
      Dim obj1 As New Examples.Object1()
      outputBlock.Text += obj1.ToString()
   End Sub
End Module
' The example displays the following output:
'   SilverlightApplication.Examples.Object1


通常、型が ToString メソッドをオーバーライドして、オブジェクト インスタンスを表す文字列を返します。たとえば CharInt32String などの基本データ型は、オブジェクトが表す値を文字列として返すために ToString の実装を提供します。次の例では、ToStringメソッドをオーバーライドするクラス (Object2) を定義して、型名と値を返します。


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 Demo(outputBlock As System.Windows.Controls.TextBlock)
      Dim obj2 As New Object2("a"c)
      outputBlock.Text += obj2.ToString()
   End Sub
End Module
' The example displays the following output:
'       SilverlightApplication.Object2: a


実装時の注意

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

Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示:
© 2014 Microsoft