StackTrace.GetFrames メソッド

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

StackTrace.GetFrames メソッド

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

現在のスタック トレース内のすべてのスタック フレームのコピーを返します。

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

Visual Basic (宣言)

<ComVisibleAttribute(False)> _
Public Overridable Function
 GetFrames As StackFrame()

Visual Basic (使用法)

Dim instance As StackTrace
Dim returnValue As StackFrame()

returnValue = instance.GetFrames

C#

[ComVisibleAttribute(false)] 
public virtual StackFrame[] GetFrames ()

C++

[ComVisibleAttribute(false)] 
public:
virtual array<StackFrame^>^ GetFrames ()

J#

/** @attribute ComVisibleAttribute(false) */ 
public StackFrame[] GetFrames ()

JScript

ComVisibleAttribute(false) 
public function GetFrames () : StackFrame[]

戻り値
スタック トレース内の関数呼び出しを表す型 StackFrame の配列。

解説

返された StackFrame 配列を使用して、StackTrace 内の関数呼び出しを列挙し、調べます。返された配列の長さは、FrameCount プロパティ値と同じです。

StackFrame 配列要素は、逆発生順です。配列インデックス 0 の StackFrame は、スタック トレース内の最新の関数呼び出し、つまり呼び出しスタックにプッシュされた最後のフレームを表します。配列インデックス FrameCount -1 の StackFrame は、呼び出しスタック内の最も古い関数呼び出し、つまり呼び出しスタックに最初にプッシュされたフレームを表します。

スタック トレース内のすべてのスタック フレームを取得する場合は GetFrames メソッドを使用し、スタック トレース内の特定のスタック フレームを取得する場合は GetFrame メソッドを使用します。StackFrame インデックスは、2 つのメソッドと同様の並び順になります。たとえば、GetFrames によって返される配列内のインデックス 0 の StackFrame は、入力インデックス 0 で GetFrame によって返される StackFrame と同じです。

使用例

StackTrace 内のフレームの列挙のコード例を次に示します。

Visual Basic

Dim strace As New StackTrace(1,
 True)
Dim stFrames As StackFrame() = strace.GetFrames()

Dim sf As StackFrame
For Each sf In  stFrames
   Console.WriteLine("Method: {0}", sf.GetMethod())
Next sf

C#

StackTrace st = new StackTrace(1, true);
StackFrame [] stFrames = st.GetFrames();

foreach(StackFrame sf in stFrames )
{
   Console.WriteLine("Method: {0}", sf.GetMethod() );
}

C++

StackTrace^ st = gcnew StackTrace( 1,true );
array<StackFrame^>^stFrames = st->GetFrames();
for ( int i; i < stFrames->Length; i++
 )
{
   StackFrame^ sf = stFrames[ i ];
   Console::WriteLine( "Method: {0}", sf->GetMethod() );

}

J#

StackTrace st = new StackTrace(1, true);
StackFrame stFrames[] = st.GetFrames();
for (int iCtr = 0; iCtr < stFrames.get_Length();
 iCtr++) {
    StackFrame sf = (StackFrame)stFrames.get_Item(iCtr);
    Console.WriteLine("Method: {0}", sf.GetMethod());
}

プラットフォーム

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

参照

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