StackTrace コンストラクタ ()

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

StackTrace コンストラクタ ()

StackTrace クラスの新しいインスタンスを呼び出し元のフレームから初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New StackTrace

C#

public StackTrace ()

C++

public:
StackTrace ()

J#

public StackTrace ()

JScript

public function StackTrace ()

解説

StackTrace は、呼び出し元の現在のスレッドで作成され、ファイル名、行番号、および列情報を含みません。

コール スタックに関するメソッドの概要情報だけを持つ完全なトレースが必要な場合は、この既定のコンストラクタを使用します。

使用例

スタック トレース内の最初と最後の関数呼び出しを表示するコード例を次に示します。

Visual Basic

Public Sub Level5Method()
   Try
      Dim nestedClass As New
 ClassLevel6()
      nestedClass.Level6Method()
   Catch e As Exception
      Console.WriteLine(" Level5Method exception handler")
      
      Dim st As New StackTrace()
      
      ' Display the most recent function call.
      Dim sf As StackFrame = st.GetFrame(0)
      Console.WriteLine()
      Console.WriteLine("  Exception in method: ")
      Console.WriteLine("      {0}", sf.GetMethod())
      
      If st.FrameCount > 1 Then
         ' Display the highest-level function call in the trace.
         sf = st.GetFrame((st.FrameCount - 1))
         Console.WriteLine("  Original function call at top of
 call stack):")
         Console.WriteLine("      {0}", sf.GetMethod())
      End If
      
      Console.WriteLine()
      Console.WriteLine("   ... throwing exception to next level
 ...")
      Console.WriteLine("-------------------------------------------------")
      Console.WriteLine()
      Throw e
   End Try
End Sub 'Level5Method

C#

public void Level5Method()
{
   try 
   {
      ClassLevel6 nestedClass = new ClassLevel6();
      nestedClass.Level6Method();
   }
   catch (Exception e) 
   {
      Console.WriteLine(" Level5Method exception handler");

      StackTrace st = new StackTrace();
      
      // Display the most recent function call.
      StackFrame sf = st.GetFrame(0);
      Console.WriteLine();
      Console.WriteLine("  Exception in method: ");
      Console.WriteLine("      {0}", sf.GetMethod());

      if (st.FrameCount >1)
      {
         // Display the highest-level function call 
         // in the trace.
         sf = st.GetFrame(st.FrameCount-1);
         Console.WriteLine("  Original function call at top of call stack):");
         Console.WriteLine("      {0}", sf.GetMethod());
      }

      Console.WriteLine();
      Console.WriteLine("   ... throwing exception to next level ...");
      Console.WriteLine("-------------------------------------------------\n");
      throw e;
   }        
}

C++

void Level5Method()
{
   try
   {
      ClassLevel6^ nestedClass = gcnew ClassLevel6;
      nestedClass->Level6Method();
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( " Level5Method exception handler" );
      StackTrace^ st = gcnew StackTrace;
      
      // Display the most recent function call.
      StackFrame^ sf = st->GetFrame( 0 );
      Console::WriteLine();
      Console::WriteLine( "  Exception in method: "
 );
      Console::WriteLine( "      {0}", sf->GetMethod() );
      if ( st->FrameCount > 1 )
      {
         
         // Display the highest-level function call
         // in the trace.
         sf = st->GetFrame( st->FrameCount - 1 );
         Console::WriteLine( "  Original function call at top of call stack):"
 );
         Console::WriteLine( "      {0}", sf->GetMethod() );
      }
      Console::WriteLine();
      Console::WriteLine( "   ... throwing exception to next level ..."
 );
      Console::WriteLine( "-------------------------------------------------\n"
 );
      throw e;
   }

}

J#

public void Level5Method() throws System.Exception
{
    try {
        ClassLevel6 nestedClass = new ClassLevel6();
        nestedClass.Level6Method();
    }
    catch (System.Exception e) {
        Console.WriteLine(" Level5Method exception handler");
        StackTrace st = new StackTrace();

        // Display the most recent function call.
        StackFrame sf = st.GetFrame(0);
        Console.WriteLine();
        Console.WriteLine("  Exception in method: ");
        Console.WriteLine("      {0}", sf.GetMethod());

        if (st.get_FrameCount() > 1) {
            // Display the highest-level function call 
            // in the trace.
            sf = st.GetFrame(st.get_FrameCount() - 1);
            Console.WriteLine("  Original function call at top of call "
                + "stack):");
            Console.WriteLine("      {0}", sf.GetMethod());
        }

        Console.WriteLine();
        Console.WriteLine(" ... throwing exception to next level...");
        Console.WriteLine("--------------------------------------------"
            + "-----\n");
        throw e;
    }
} //Level5Method

プラットフォーム

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、1.1、1.0

参照

関連項目
StackTrace クラス
StackTrace メンバ
System.Diagnostics 名前空間

StackTrace コンストラクタ (Exception)

指定した例外オブジェクトを使用して、StackTrace クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    e As Exception _
)

Visual Basic (使用法)

Dim e As Exception

Dim instance As New StackTrace(e)

C#

public StackTrace (
    Exception e
)

C++

public:
StackTrace (
    Exception^ e
)

J#

public StackTrace (
    Exception e
)

JScript

public function StackTrace (
    e : Exception
)

パラメータ

e

スタック トレースを構築する基となる例外オブジェクト。

例外

例外の種類	条件
ArgumentNullException	e パラメータが null 参照 (Visual Basic では Nothing) です。

解説

StackTrace は、呼び出し元の現在のスレッドで作成され、ファイル名、行番号、および列情報を含みません。

結果として得られるスタック トレースは、例外が発生した時点のスタックを説明します。

プラットフォーム

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、1.1、1.0

参照

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

StackTrace コンストラクタ (StackFrame)

単一フレームを格納している StackTrace クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    frame As StackFrame _
)

Visual Basic (使用法)

Dim frame As StackFrame

Dim instance As New StackTrace(frame)

C#

public StackTrace (
    StackFrame frame
)

C++

public:
StackTrace (
    StackFrame^ frame
)

J#

public StackTrace (
    StackFrame frame
)

JScript

public function StackTrace (
    frame : StackFrame
)

パラメータ

frame

StackTrace オブジェクトに格納するフレーム。

解説

フル スタック トレースのオーバーヘッドを回避する場合に、このコンストラクタを使用します。

使用例

スタック トレース情報をイベント ログ エントリに書き込むコード例を次に示します。

Visual Basic

Dim frame As New StackFrame(1,
 True)
Dim strace As New StackTrace(frame)
            

EventLog.WriteEntry(frame.GetMethod().Name, _
                    strace.ToString(), _
                    EventLogEntryType.Warning)

C#

StackFrame fr = new StackFrame(1,true);
StackTrace st = new StackTrace(fr);
EventLog.WriteEntry(fr.GetMethod().Name,
                    st.ToString(),
                    EventLogEntryType.Warning);

C++

StackFrame^ fr = gcnew StackFrame( 1,true );
StackTrace^ st = gcnew StackTrace( fr );
EventLog::WriteEntry( fr->GetMethod()->Name, st->ToString(), EventLogEntryType::Warning
 );

J#

StackFrame fr = new StackFrame(1, true);
StackTrace st = new StackTrace(fr);
EventLog.WriteEntry(fr.GetMethod().get_Name(), st.ToString(),
    EventLogEntryType.Warning);

プラットフォーム

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、1.1、1.0

参照

関連項目
StackTrace クラス
StackTrace メンバ
System.Diagnostics 名前空間
StackFrame クラス

StackTrace コンストラクタ (Boolean)

StackTrace クラスの新しいインスタンスを呼び出し元のフレームから初期化し、オプションでソース情報をキャプチャします。

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

Visual Basic (宣言)

Public Sub New ( _
    fNeedFileInfo As Boolean _
)

Visual Basic (使用法)

Dim fNeedFileInfo As Boolean

Dim instance As New StackTrace(fNeedFileInfo)

C#

public StackTrace (
    bool fNeedFileInfo
)

C++

public:
StackTrace (
    bool fNeedFileInfo
)

J#

public StackTrace (
    boolean fNeedFileInfo
)

JScript

public function StackTrace (
    fNeedFileInfo : boolean
)

パラメータ

fNeedFileInfo

ファイル名、行番号、および列番号をキャプチャする場合は true。それ以外の場合は false。

解説

StackTrace は、呼び出し元の現在のスレッドで作成されます。

使用例

さまざまな StackTrace コンストラクタ メソッドのコード例を次に示します。

Visual Basic

Public Sub Level2Method()
   Try
      Dim nestedClass As New
 ClassLevel3
      nestedClass.Level3Method()
   
   Catch e As Exception
      Console.WriteLine(" Level2Method exception handler")
      
      ' Display the full call stack at this level.
      Dim st1 As New StackTrace(True)
      Console.WriteLine(" Stack trace for this level: {0}",
 _
         st1.ToString())
      
      ' Build a stack trace from one frame, skipping the current
      ' frame and using the next frame.
      Dim st2 As New StackTrace(New
 StackFrame(1, True))
      Console.WriteLine(" Stack trace built with next level frame:
 {0}", _
          st2.ToString())
      
      ' Build a stack trace skipping the current frame, and
      ' including all the other frames.
      Dim st3 As New StackTrace(1,
 True)
      Console.WriteLine(" Stack trace built from the next level
 up: {0}", _
          st3.ToString())
      
      Console.WriteLine()
      Console.WriteLine("   ... throwing exception to next level
 ...")
      Console.WriteLine("-------------------------------------------------")
      Console.WriteLine()
      Throw e
   End Try
End Sub 'Level2Method

C#

public void Level2Method()
{
   try 
   {
      ClassLevel3 nestedClass = new ClassLevel3();
      nestedClass.Level3Method();

   }
   catch (Exception e) 
   {
      Console.WriteLine(" Level2Method exception handler");

      // Display the full call stack at this level.
      StackTrace st1 = new StackTrace(true);
      Console.WriteLine(" Stack trace for this
 level: {0}",
         st1.ToString());

      // Build a stack trace from one frame, skipping the current
      // frame and using the next frame.
      StackTrace st2 = new StackTrace(new StackFrame(1,
 true));
      Console.WriteLine(" Stack trace built with next level frame: {0}"
,
         st2.ToString());

      // Build a stack trace skipping the current frame, and
      // including all the other frames.
      StackTrace st3 = new StackTrace(1, true);
      Console.WriteLine(" Stack trace built from the next level up: {0}"
,
         st3.ToString());

      Console.WriteLine();
      Console.WriteLine("   ... throwing exception to next level ...");
      Console.WriteLine("-------------------------------------------------\n");
      throw e;
   }
}

C++

void Level2Method()
{
   try
   {
      ClassLevel3^ nestedClass = gcnew ClassLevel3;
      nestedClass->Level3Method();
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( " Level2Method exception handler" );
      
      // Display the full call stack at this level.
      StackTrace^ st1 = gcnew StackTrace( true );
      Console::WriteLine( " Stack trace for this
 level: {0}", st1->ToString() );
      
      // Build a stack trace from one frame, skipping the
      // current frame and using the next frame.
      StackTrace^ st2 = gcnew StackTrace( gcnew StackFrame( 1,true
 ) );
      Console::WriteLine( " Stack trace built with next level frame: {0}",
 st2->ToString() );
      
      // Build a stack trace skipping the current frame, and
      // including all the other frames.
      StackTrace^ st3 = gcnew StackTrace( 1,true );
      Console::WriteLine( " Stack trace built from the next level up: {0}",
 st3->ToString() );
      Console::WriteLine();
      Console::WriteLine( "   ... throwing exception to next level ..."
 );
      Console::WriteLine( "-------------------------------------------------\n"
 );
      throw e;
   }

}

J#

public void Level2Method() throws System.Exception
{
    try {
        ClassLevel3 nestedClass = new ClassLevel3();
        nestedClass.Level3Method();
    }
    catch (System.Exception e) {
        Console.WriteLine(" Level2Method exception handler");

        // Display the full call stack at this level.
        StackTrace st1 = new StackTrace(true);
        Console.WriteLine(" Stack trace for this
 level: {0}", 
            st1.ToString());

        // Build a stack trace from one frame, skipping the current
        // frame and using the next frame.
        StackTrace st2 = new StackTrace(new StackFrame(1,
 true));
        Console.WriteLine(" Stack trace built with next level frame: {0}"
,
            st2.ToString());

        // Build a stack trace skipping the current frame, and
        // including all the other frames.
        StackTrace st3 = new StackTrace(1, true);
        Console.WriteLine(" Stack trace built from the next level up: {0}"
,
            st3.ToString());
        Console.WriteLine();
        Console.WriteLine(" ... throwing exception to next level...");
        Console.WriteLine("--------------------------------------------"
            + "-----\n");
        throw e;
    }
} //Level2Method

プラットフォーム

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、1.1、1.0

参照

関連項目
StackTrace クラス
StackTrace メンバ
System.Diagnostics 名前空間

StackTrace コンストラクタ (Exception, Int32, Boolean)

指定した例外オブジェクトを使用して、StackTrace クラスの新しいインスタンスを初期化し、指定したフレーム数をスキップしたり、必要に応じてソース情報を取得したりできます。

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

Visual Basic (宣言)

Public Sub New ( _
    e As Exception, _
    skipFrames As Integer, _
    fNeedFileInfo As Boolean _
)

Visual Basic (使用法)

Dim e As Exception
Dim skipFrames As Integer
Dim fNeedFileInfo As Boolean

Dim instance As New StackTrace(e,
 skipFrames, fNeedFileInfo)

C#

public StackTrace (
    Exception e,
    int skipFrames,
    bool fNeedFileInfo
)

C++

public:
StackTrace (
    Exception^ e, 
    int skipFrames, 
    bool fNeedFileInfo
)

J#

public StackTrace (
    Exception e, 
    int skipFrames, 
    boolean fNeedFileInfo
)

JScript

public function StackTrace (
    e : Exception, 
    skipFrames : int, 
    fNeedFileInfo : boolean
)

パラメータ

e

スタック トレースを構築する基となる例外オブジェクト。

skipFrames

トレースを開始するスタックまでのフレーム数。

fNeedFileInfo

ファイル名、行番号、および列番号をキャプチャする場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentNullException	e パラメータが null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	skipFrames パラメータが負の値です。

解説

結果として得られるスタック トレースは、例外が発生した時点のスタックを説明します。

インスタンスの作成時に、スキップするフレームの数がコール スタック上のフレームの合計数以上の場合は、StackTrace にフレームは含まれません。

プラットフォーム

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、1.1、1.0

参照

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

StackTrace コンストラクタ (Exception, Boolean)

指定した例外オブジェクトを使用して StackTrace クラスの新しいインスタンスを初期化し、オプションでソース情報をキャプチャします。

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

Visual Basic (宣言)

Public Sub New ( _
    e As Exception, _
    fNeedFileInfo As Boolean _
)

Visual Basic (使用法)

Dim e As Exception
Dim fNeedFileInfo As Boolean

Dim instance As New StackTrace(e,
 fNeedFileInfo)

C#

public StackTrace (
    Exception e,
    bool fNeedFileInfo
)

C++

public:
StackTrace (
    Exception^ e, 
    bool fNeedFileInfo
)

J#

public StackTrace (
    Exception e, 
    boolean fNeedFileInfo
)

JScript

public function StackTrace (
    e : Exception, 
    fNeedFileInfo : boolean
)

パラメータ

e

スタック トレースを構築する基となる例外オブジェクト。

fNeedFileInfo

ファイル名、行番号、および列番号をキャプチャする場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentNullException	e パラメータが null 参照 (Visual Basic では Nothing) です。

解説

結果として得られるスタック トレースは、例外が発生した時点のスタックを説明します。

プラットフォーム

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、1.1、1.0

参照

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

StackTrace コンストラクタ (Int32, Boolean)

呼び出し元のフレームから StackTrace クラスの新しいインスタンスを初期化し、指定した数のフレームをスキップしたり、必要に応じてソース情報を取得したりできます。

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

Visual Basic (宣言)

Public Sub New ( _
    skipFrames As Integer, _
    fNeedFileInfo As Boolean _
)

Visual Basic (使用法)

Dim skipFrames As Integer
Dim fNeedFileInfo As Boolean

Dim instance As New StackTrace(skipFrames,
 fNeedFileInfo)

C#

public StackTrace (
    int skipFrames,
    bool fNeedFileInfo
)

C++

public:
StackTrace (
    int skipFrames, 
    bool fNeedFileInfo
)

J#

public StackTrace (
    int skipFrames, 
    boolean fNeedFileInfo
)

JScript

public function StackTrace (
    skipFrames : int, 
    fNeedFileInfo : boolean
)

パラメータ

skipFrames

トレースを開始するスタックまでのフレーム数。

fNeedFileInfo

ファイル名、行番号、および列番号をキャプチャする場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentOutOfRangeException	skipFrames パラメータが負の値です。

解説

インスタンスの作成時に、スキップするフレームの数がコール スタック上のフレームの合計数以上の場合は、StackTrace にフレームは含まれません。

使用例

さまざまな StackTrace コンストラクタ メソッドのコード例を次に示します。

Visual Basic

Public Sub Level2Method()
   Try
      Dim nestedClass As New
 ClassLevel3
      nestedClass.Level3Method()
   
   Catch e As Exception
      Console.WriteLine(" Level2Method exception handler")
      
      ' Display the full call stack at this level.
      Dim st1 As New StackTrace(True)
      Console.WriteLine(" Stack trace for this level: {0}",
 _
         st1.ToString())
      
      ' Build a stack trace from one frame, skipping the current
      ' frame and using the next frame.
      Dim st2 As New StackTrace(New
 StackFrame(1, True))
      Console.WriteLine(" Stack trace built with next level frame:
 {0}", _
          st2.ToString())
      
      ' Build a stack trace skipping the current frame, and
      ' including all the other frames.
      Dim st3 As New StackTrace(1,
 True)
      Console.WriteLine(" Stack trace built from the next level
 up: {0}", _
          st3.ToString())
      
      Console.WriteLine()
      Console.WriteLine("   ... throwing exception to next level
 ...")
      Console.WriteLine("-------------------------------------------------")
      Console.WriteLine()
      Throw e
   End Try
End Sub 'Level2Method

C#

public void Level2Method()
{
   try 
   {
      ClassLevel3 nestedClass = new ClassLevel3();
      nestedClass.Level3Method();

   }
   catch (Exception e) 
   {
      Console.WriteLine(" Level2Method exception handler");

      // Display the full call stack at this level.
      StackTrace st1 = new StackTrace(true);
      Console.WriteLine(" Stack trace for this
 level: {0}",
         st1.ToString());

      // Build a stack trace from one frame, skipping the current
      // frame and using the next frame.
      StackTrace st2 = new StackTrace(new StackFrame(1,
 true));
      Console.WriteLine(" Stack trace built with next level frame: {0}"
,
         st2.ToString());

      // Build a stack trace skipping the current frame, and
      // including all the other frames.
      StackTrace st3 = new StackTrace(1, true);
      Console.WriteLine(" Stack trace built from the next level up: {0}"
,
         st3.ToString());

      Console.WriteLine();
      Console.WriteLine("   ... throwing exception to next level ...");
      Console.WriteLine("-------------------------------------------------\n");
      throw e;
   }
}

C++

void Level2Method()
{
   try
   {
      ClassLevel3^ nestedClass = gcnew ClassLevel3;
      nestedClass->Level3Method();
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( " Level2Method exception handler" );
      
      // Display the full call stack at this level.
      StackTrace^ st1 = gcnew StackTrace( true );
      Console::WriteLine( " Stack trace for this
 level: {0}", st1->ToString() );
      
      // Build a stack trace from one frame, skipping the
      // current frame and using the next frame.
      StackTrace^ st2 = gcnew StackTrace( gcnew StackFrame( 1,true
 ) );
      Console::WriteLine( " Stack trace built with next level frame: {0}",
 st2->ToString() );
      
      // Build a stack trace skipping the current frame, and
      // including all the other frames.
      StackTrace^ st3 = gcnew StackTrace( 1,true );
      Console::WriteLine( " Stack trace built from the next level up: {0}",
 st3->ToString() );
      Console::WriteLine();
      Console::WriteLine( "   ... throwing exception to next level ..."
 );
      Console::WriteLine( "-------------------------------------------------\n"
 );
      throw e;
   }

}

J#

public void Level2Method() throws System.Exception
{
    try {
        ClassLevel3 nestedClass = new ClassLevel3();
        nestedClass.Level3Method();
    }
    catch (System.Exception e) {
        Console.WriteLine(" Level2Method exception handler");

        // Display the full call stack at this level.
        StackTrace st1 = new StackTrace(true);
        Console.WriteLine(" Stack trace for this
 level: {0}", 
            st1.ToString());

        // Build a stack trace from one frame, skipping the current
        // frame and using the next frame.
        StackTrace st2 = new StackTrace(new StackFrame(1,
 true));
        Console.WriteLine(" Stack trace built with next level frame: {0}"
,
            st2.ToString());

        // Build a stack trace skipping the current frame, and
        // including all the other frames.
        StackTrace st3 = new StackTrace(1, true);
        Console.WriteLine(" Stack trace built from the next level up: {0}"
,
            st3.ToString());
        Console.WriteLine();
        Console.WriteLine(" ... throwing exception to next level...");
        Console.WriteLine("--------------------------------------------"
            + "-----\n");
        throw e;
    }
} //Level2Method

プラットフォーム

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、1.1、1.0

参照

関連項目
StackTrace クラス
StackTrace メンバ
System.Diagnostics 名前空間

StackTrace コンストラクタ

StackTrace クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
StackTrace ()	StackTrace クラスの新しいインスタンスを呼び出し元のフレームから初期化します。
StackTrace (Boolean)	StackTrace クラスの新しいインスタンスを呼び出し元のフレームから初期化し、オプションでソース情報をキャプチャします。
StackTrace (Exception)	指定した例外オブジェクトを使用して、StackTrace クラスの新しいインスタンスを初期化します。
StackTrace (Int32)	呼び出し元のフレームから StackTrace クラスの新しいインスタンスを初期化し、指定した数のフレームをスキップします。
StackTrace (StackFrame)	単一フレームを格納している StackTrace クラスの新しいインスタンスを初期化します。
StackTrace (Exception, Boolean)	指定した例外オブジェクトを使用して StackTrace クラスの新しいインスタンスを初期化し、オプションでソース情報をキャプチャします。
StackTrace (Exception, Int32)	指定した例外オブジェクトを使用して StackTrace クラスの新しいインスタンスを初期化し、指定した数のフレームをスキップします。
StackTrace (Int32, Boolean)	呼び出し元のフレームから StackTrace クラスの新しいインスタンスを初期化し、指定した数のフレームをスキップしたり、必要に応じてソース情報を取得したりできます。
StackTrace (Thread, Boolean)	指定したスレッド用に StackTrace クラスの新しいインスタンスを初期化し、オプションでソース情報をキャプチャします。
StackTrace (Exception, Int32, Boolean)	指定した例外オブジェクトを使用して、StackTrace クラスの新しいインスタンスを初期化し、指定したフレーム数をスキップしたり、必要に応じてソース情報を取得したりできます。

参照

関連項目

StackTrace クラス
StackTrace メンバ
System.Diagnostics 名前空間

StackTrace コンストラクタ (Thread, Boolean)

指定したスレッド用に StackTrace クラスの新しいインスタンスを初期化し、オプションでソース情報をキャプチャします。

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

Visual Basic (宣言)

Public Sub New ( _
    targetThread As Thread, _
    needFileInfo As Boolean _
)

Visual Basic (使用法)

Dim targetThread As Thread
Dim needFileInfo As Boolean

Dim instance As New StackTrace(targetThread,
 needFileInfo)

C#

public StackTrace (
    Thread targetThread,
    bool needFileInfo
)

C++

public:
StackTrace (
    Thread^ targetThread, 
    bool needFileInfo
)

J#

public StackTrace (
    Thread targetThread, 
    boolean needFileInfo
)

JScript

public function StackTrace (
    targetThread : Thread, 
    needFileInfo : boolean
)

パラメータ

targetThread

スタック トレースを要求するスレッド。

needFileInfo

ファイル名、行番号、および列番号をキャプチャする場合は true。それ以外の場合は false。

例外

例外の種類	条件
ThreadStateException	スレッド targetThread が中断されていません。

解説

StackTrace を現在のスレッドではないターゲット スレッドで作成する場合、まずターゲット スレッドを中断する必要があります。

プラットフォーム

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、1.1、1.0

参照

関連項目
StackTrace クラス
StackTrace メンバ
System.Diagnostics 名前空間
Thread

StackTrace コンストラクタ (Exception, Int32)

指定した例外オブジェクトを使用して StackTrace クラスの新しいインスタンスを初期化し、指定した数のフレームをスキップします。

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

Visual Basic (宣言)

Public Sub New ( _
    e As Exception, _
    skipFrames As Integer _
)

Visual Basic (使用法)

Dim e As Exception
Dim skipFrames As Integer

Dim instance As New StackTrace(e,
 skipFrames)

C#

public StackTrace (
    Exception e,
    int skipFrames
)

C++

public:
StackTrace (
    Exception^ e, 
    int skipFrames
)

J#

public StackTrace (
    Exception e, 
    int skipFrames
)

JScript

public function StackTrace (
    e : Exception, 
    skipFrames : int
)

パラメータ

e

スタック トレースを構築する基となる例外オブジェクト。

skipFrames

トレースを開始するスタックまでのフレーム数。

例外

例外の種類	条件
ArgumentNullException	e パラメータが null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	skipFrames パラメータが負の値です。

解説

StackTrace は、ファイル名、行番号、または列情報を含みません。

結果として得られるスタック トレースは、例外が発生した時点のスタックを説明します。

インスタンスの作成時に、スキップするフレームの数がコール スタック上のフレームの合計数以上の場合は、StackTrace にフレームは含まれません。

プラットフォーム

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、1.1、1.0

参照

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

StackTrace コンストラクタ (Int32)

呼び出し元のフレームから StackTrace クラスの新しいインスタンスを初期化し、指定した数のフレームをスキップします。

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

Visual Basic (宣言)

Public Sub New ( _
    skipFrames As Integer _
)

Visual Basic (使用法)

Dim skipFrames As Integer

Dim instance As New StackTrace(skipFrames)

C#

public StackTrace (
    int skipFrames
)

C++

public:
StackTrace (
    int skipFrames
)

J#

public StackTrace (
    int skipFrames
)

JScript

public function StackTrace (
    skipFrames : int
)

パラメータ

skipFrames

トレースを開始するスタックまでのフレーム数。

例外

例外の種類	条件
ArgumentOutOfRangeException	skipFrames パラメータが負の値です。

解説

StackTrace は、呼び出し元の現在のスレッドで作成され、ファイル名、行番号、および列情報を含みません。

インスタンスの作成時に、スキップするフレームの数がコール スタック上のフレームの合計数以上の場合は、StackTrace にフレームは含まれません。

プラットフォーム

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、1.1、1.0

参照

関連項目
StackTrace クラス
StackTrace メンバ
System.Diagnostics 名前空間