Exception.ToString

.NET Framework クラス ライブラリ リファレンス

Exception.ToString メソッド

現在の例外の文字列形式を作成して返します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 ToString As String

Visual Basic (使用法)

Dim instance As Exception
Dim returnValue As String

returnValue = instance.ToString

C#

public override string ToString ()

C++

public:
virtual String^ ToString () override

J#

public String ToString ()

JScript

public override function ToString () : String

戻り値
現在の例外の文字列形式。

解説

ToString は、ユーザーが判読できる形式で現在の例外を返します。カルチャの違いにかかわるデータが例外に含まれている場合、ToString によって返される文字列形式には現在のシステムのカルチャが反映されている必要があります。返される文字列の書式については明確な要件はありませんが、オブジェクトの値をユーザーが認識できる形で表現するようにしてください。

ToString の既定の実装は、現在の例外をスローしたクラスの名前、メッセージ、内部例外での ToString の呼び出しの結果、および Environment.StackTrace の呼び出しの結果を取得します。これらのメンバのいずれかが null 参照 (Visual Basic では Nothing) である場合、その値は返される文字列に含まれません。

エラー メッセージがないか、またはエラー メッセージが空の文字列 ("") である場合、エラー メッセージは返されません。内部例外とスタック トレースが null 参照 (Visual Basic では Nothing) でない場合だけ、その名前が返されます。

このメソッドは、Object.ToString をオーバーライドします。

使用例

例外を発生させ、その例外で ToString を呼び出した結果の例を次に示します。

Visual Basic

Imports System

Public Class [MyClass]
End Class '[MyClass]

Public Class ArgExceptionExample
   
   Public Shared Sub Main()
      Dim my As New [MyClass]()
      Dim s As String =
 "sometext"
      Try
         Dim i As Integer
 = s.CompareTo(my)
      Catch e As Exception
         Console.WriteLine("Error: {0}", e.ToString())
      End Try
   End Sub 'Main
End Class 'ArgExceptionExample

C#

using System;

public class MyClass {}
public class ArgExceptionExample 
   {
   public static void Main()
      {
      MyClass my = new MyClass();
      string s = "sometext";
      try 
         {
         int i = s.CompareTo(my);
         }
            catch (Exception e) 
            {
            Console.WriteLine("Error: {0}",e.ToString());
            }
      }
}

C++

using namespace System;
public ref class MyClass{};

int main()
{
   MyClass^ my = gcnew MyClass;
   String^ s = "sometext";
   try
   {
      int i = s->CompareTo( my );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Error: {0}", e->ToString() );
   }

}

J#

import System.*;

public class MyClass
{
} //MyClass

public class ArgExceptionExample
{
    public static void main(String[]
 args)
    {
        MyClass my = new MyClass();
        String s = "sometext";
        try {
            int i = s.CompareTo(my);
        }
        catch (System.Exception e) {
            Console.WriteLine("Error: {0}", e.ToString());
        }
    } //main
} //ArgExceptionExample

JScript

import System;

public class MyClass {}
public class ArgExceptionExample 
   {
   public static function
 Main()
      {
      var my : MyClass = new MyClass();
      var s : String = "sometext";
      try 
         {
         var i : int = s.CompareTo(my);
         }
     catch (e : Exception) 
         {
         Console.WriteLine("Error: {0}",e.ToString());
         }
      }
}

このコードによって、次の出力が生成されます。

Error: System.ArgumentException: Object must be of type String. at System.String.CompareTo(Object
 value) at ArgExceptionExample.Main()

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Exception クラス
Exception メンバ
System 名前空間

_Exception.ToString メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

COM オブジェクトに、Exception.ToString メソッドへのバージョンに依存しないアクセスが用意されています。

このメソッドは、CLS に準拠していません。  

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Function ToString As String

Visual Basic (使用法)

Dim instance As _Exception
Dim returnValue As String

returnValue = instance.ToString

C#

string ToString ()

C++

String^ ToString ()

J#

String ToString ()

JScript

function ToString () : String

戻り値
現在の System.Exception オブジェクトを表す文字列。

解説

このメソッドは、アンマネージ コードからマネージ クラスにアクセスするためのメソッドであるため、マネージ コードからは呼び出さないでください。

Exception.ToString メソッドは、現在の例外の文字列形式を作成して返します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
_Exception インターフェイス
_Exception メンバ
System.Runtime.InteropServices 名前空間
Exception.ToString