StackTrace クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
スタック トレースを表します。スタック トレースは、順番に並べられた 1 つまたは複数のスタック フレームのコレクションです。
public ref class StackTrace sealedpublic ref class StackTracepublic sealed class StackTracepublic class StackTrace[System.Serializable]
public class StackTrace[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StackTracetype StackTrace = class[<System.Serializable>]
type StackTrace = class[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StackTrace = classPublic NotInheritable Class StackTracePublic Class StackTrace- 継承
-
StackTrace
- 属性
例
次のコンソール アプリケーションは、単純な StackTrace を作成し、そのフレームを反復処理してデバッグと診断情報を取得する方法を示しています。
#using <System.dll>
using namespace System;
using namespace System::Diagnostics;
ref class StackTraceSample
{
private:
ref class MyInternalClass
{
public:
void ThrowsException()
{
try
{
throw gcnew Exception( "A problem was encountered." );
}
catch ( Exception^ e )
{
// Create a StackTrace that captures
// filename, line number, and column
// information for the current thread.
StackTrace^ st = gcnew StackTrace( true );
String^ stackIndent = "";
for ( int i = 0; i < st->FrameCount; i++ )
{
// Note that at this level, there are five
// stack frames, one for each method invocation.
StackFrame^ sf = st->GetFrame( i );
Console::WriteLine();
Console::WriteLine( "{0}Method: {1}", stackIndent, sf->GetMethod() );
Console::WriteLine( "{0}File: {1}", stackIndent, sf->GetFileName() );
Console::WriteLine( "{0}Line Number: {1}", stackIndent, sf->GetFileLineNumber().ToString() );
stackIndent = String::Concat( stackIndent, " " );
}
throw e;
}
}
};
protected:
void MyProtectedMethod()
{
MyInternalClass^ mic = gcnew MyInternalClass;
mic->ThrowsException();
}
public:
void MyPublicMethod()
{
MyProtectedMethod();
}
};
int main()
{
StackTraceSample^ sample = gcnew StackTraceSample;
try
{
sample->MyPublicMethod();
}
catch ( Exception^ )
{
// Create a StackTrace that captures
// filename, line number, and column
// information for the current thread.
StackTrace^ st = gcnew StackTrace( true );
for ( int i = 0; i < st->FrameCount; i++ )
{
// For an executable built from C++, there
// are two stack frames here: one for main,
// and one for the _mainCRTStartup stub.
StackFrame^ sf = st->GetFrame( i );
Console::WriteLine();
Console::WriteLine( "High up the call stack, Method: {0}", sf->GetMethod()->ToString() );
Console::WriteLine( "High up the call stack, Line Number: {0}", sf->GetFileLineNumber().ToString() );
}
}
}
/*
This console application produces the following output when
compiled with the Debug configuration.
Method: Void ThrowsException()
File: c:\samples\stacktraceframe\myclass.cpp
Line Number: 20
Method: Void MyProtectedMethod()
File: c:\samples\stacktraceframe\myclass.cpp
Line Number: 45
Method: Void MyPublicMethod()
File: c:\samples\stacktraceframe\myclass.cpp
Line Number: 50
Method: Int32 main()
File: c:\samples\stacktraceframe\myclass.cpp
Line Number: 56
Method: UInt32 _mainCRTStartup()
File:
Line Number: 0
High up the call stack, Method: Int32 main()
High up the call stack, Line Number: 62
High up the call stack, Method: UInt32 _mainCRTStartup()
High up the call stack, Line Number: 0
This console application produces the following output when
compiled with the Release configuration.
Method: Void ThrowsException()
File:
Line Number: 0
Method: Int32 main()
File:
Line Number: 0
Method: UInt32 _mainCRTStartup()
File:
Line Number: 0
High up the call stack, Method: Int32 main()
High up the call stack, Line Number: 0
High up the call stack, Method: UInt32 _mainCRTStartup()
High up the call stack, Line Number: 0
*/
using System;
using System.Diagnostics;
class StackTraceSample
{
[STAThread]
static void Main(string[] args)
{
StackTraceSample sample = new StackTraceSample();
try
{
sample.MyPublicMethod();
}
catch (Exception)
{
// Create a StackTrace that captures
// filename, line number, and column
// information for the current thread.
StackTrace st = new StackTrace(true);
for(int i =0; i< st.FrameCount; i++ )
{
// Note that high up the call stack, there is only
// one stack frame.
StackFrame sf = st.GetFrame(i);
Console.WriteLine();
Console.WriteLine("High up the call stack, Method: {0}",
sf.GetMethod());
Console.WriteLine("High up the call stack, Line Number: {0}",
sf.GetFileLineNumber());
}
}
}
public void MyPublicMethod ()
{
MyProtectedMethod();
}
protected void MyProtectedMethod ()
{
MyInternalClass mic = new MyInternalClass();
mic.ThrowsException();
}
class MyInternalClass
{
public void ThrowsException()
{
try
{
throw new Exception("A problem was encountered.");
}
catch (Exception e)
{
// Create a StackTrace that captures filename,
// line number and column information.
StackTrace st = new StackTrace(true);
string stackIndent = "";
for(int i =0; i< st.FrameCount; i++ )
{
// Note that at this level, there are four
// stack frames, one for each method invocation.
StackFrame sf = st.GetFrame(i);
Console.WriteLine();
Console.WriteLine(stackIndent + " Method: {0}",
sf.GetMethod() );
Console.WriteLine( stackIndent + " File: {0}",
sf.GetFileName());
Console.WriteLine( stackIndent + " Line Number: {0}",
sf.GetFileLineNumber());
stackIndent += " ";
}
throw e;
}
}
}
}
/*
This console application produces the following output when
compiled with the Debug configuration.
Method: Void ThrowsException()
File: c:\samples\stacktraceframe\myclass.cs
Line Number: 59
Method: Void MyProtectedMethod()
File: c:\samples\stacktraceframe\myclass.cs
Line Number: 45
Method: Void MyPublicMethod()
File: c:\samples\stacktraceframe\myclass.cs
Line Number: 39
Method: Void Main(System.String[])
File: c:\samples\stacktraceframe\myclass.cs
Line Number: 13
High up the call stack, Method: Void Main(System.String[])
High up the call stack, Line Number: 20
This console application produces the following output when
compiled with the Release configuration.
Method: Void ThrowsException()
File:
Line Number: 0
Method: Void Main(System.String[])
File:
Line Number: 0
High up the call stack, Method: Void Main(System.String[])
High up the call stack, Line Number: 0
*/
Imports System.Diagnostics
Class StackTraceSample
<STAThread()> _
Public Shared Sub Main()
Dim sample As New StackTraceSample()
Try
sample.MyPublicMethod()
Catch
' Create a StackTrace that captures
' filename, line number, and column
' information for the current thread.
Dim st As New StackTrace(True)
Dim i As Integer
For i = 0 To st.FrameCount - 1
' Note that high up the call stack, there is only
' one stack frame.
Dim sf As StackFrame = st.GetFrame(i)
Console.WriteLine()
Console.WriteLine("High up the call stack, Method: {0}", _
sf.GetMethod())
Console.WriteLine("High up the call stack, Line Number: {0}", _
sf.GetFileLineNumber())
Next i
End Try
End Sub
Public Sub MyPublicMethod()
MyProtectedMethod()
End Sub
Protected Sub MyProtectedMethod()
Dim mic As New MyInternalClass()
mic.ThrowsException()
End Sub
Class MyInternalClass
Public Sub ThrowsException()
Try
Throw New Exception("A problem was encountered.")
Catch e As Exception
' Create a StackTrace that captures filename,
' line number and column information.
Dim st As New StackTrace(True)
Dim stackIndent As String = ""
Dim i As Integer
For i = 0 To st.FrameCount - 1
' Note that at this level, there are four
' stack frames, one for each method invocation.
Dim sf As StackFrame = st.GetFrame(i)
Console.WriteLine()
Console.WriteLine(stackIndent + " Method: {0}", _
sf.GetMethod())
Console.WriteLine(stackIndent + " File: {0}", _
sf.GetFileName())
Console.WriteLine(stackIndent + " Line Number: {0}", _
sf.GetFileLineNumber())
stackIndent += " "
Next i
Throw e
End Try
End Sub
End Class
End Class
' This console application produces the following output when
' compiled with the Debug configuration.
'
' Method: Void ThrowsException()
' File: c:\pp\samples\stacktraceframe\myclass.vb
' Line Number: 55
'
' Method: Void MyProtectedMethod()
' File: c:\pp\samples\stacktraceframe\myclass.vb
' Line Number: 42
'
' Method: Void MyPublicMethod()
' File: c:\pp\samples\stacktraceframe\myclass.vb
' Line Number: 37
'
' Method: Void Main(System.String[])
' File: c:\pp\samples\stacktraceframe\myclass.vb
' Line Number: 13
'
' High up the call stack, Method: Void Main(System.String[])
' High up the call stack, Line Number: 18
'
'
' This console application produces the following output when
' compiled with the Release configuration.
'
' Method: Void ThrowsException()
' File:
' Line Number: 0
'
' Method: Void Main(System.String[])
' File:
' Line Number: 0
'
' High up the call stack, Method: Void Main()
' High up the call stack, Line Number: 0
'
注釈
StackTrace 情報は、デバッグ ビルド構成で最も有益です。 既定では、デバッグ ビルドにはデバッグ シンボルが含まれますが、リリース ビルドには含まれません。 デバッグ シンボルには、ほとんどのファイル、メソッド名、行番号、およびオブジェクトの構築に使用される列情報がStackFrameStackTrace含まれています。
StackTrace 最適化中に発生するコード変換により、期待どおりに多くのメソッド呼び出しが報告されない場合があります。
コンストラクター
| StackTrace() |
StackTrace クラスの新しいインスタンスを呼び出し元のフレームから初期化します。 |
| StackTrace(Boolean) |
StackTrace クラスの新しいインスタンスを呼び出し元のフレームから初期化し、オプションでソース情報をキャプチャします。 |
| StackTrace(Exception) |
指定した例外オブジェクトを使用して、StackTrace クラスの新しいインスタンスを初期化します。 |
| StackTrace(Exception, Boolean) |
指定した例外オブジェクトを使用して StackTrace クラスの新しいインスタンスを初期化し、オプションでソース情報をキャプチャします。 |
| StackTrace(Exception, Int32) |
指定した例外オブジェクトを使用して StackTrace クラスの新しいインスタンスを初期化し、指定した数のフレームをスキップします。 |
| StackTrace(Exception, Int32, Boolean) |
指定した例外オブジェクトを使用して、StackTrace クラスの新しいインスタンスを初期化し、指定したフレーム数をスキップしたり、必要に応じてソース情報を取得したりできます。 |
| StackTrace(IEnumerable<StackFrame>) |
オブジェクトのセット StackFrame からスタック トレースを構築します。 |
| StackTrace(Int32) |
呼び出し元のフレームから StackTrace クラスの新しいインスタンスを初期化し、指定した数のフレームをスキップします。 |
| StackTrace(Int32, Boolean) |
呼び出し元のフレームから StackTrace クラスの新しいインスタンスを初期化し、指定した数のフレームをスキップしたり、必要に応じてソース情報を取得したりできます。 |
| StackTrace(StackFrame) |
単一フレームを格納している StackTrace クラスの新しいインスタンスを初期化します。 |
| StackTrace(Thread, Boolean) |
古い.
指定したスレッド用に StackTrace クラスの新しいインスタンスを初期化し、オプションでソース情報をキャプチャします。 このコンストラクター オーバーロードは使用しないでください。 |
フィールド
| METHODS_TO_SKIP |
スタック トレースから省略する既定のメソッド数を定義します。 このフィールドは定数です。 |
プロパティ
| FrameCount |
スタック トレース内のフレーム数を取得します。 |
メソッド
| Equals(Object) |
指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
| GetFrame(Int32) |
指定したスタック フレームを取得します。 |
| GetFrames() |
現在のスタック トレース内のすべてのスタック フレームのコピーを返します。 |
| GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
| ToString() |
スタック トレースの読み取り可能な形式を構築します。 |
適用対象
こちらもご覧ください
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示