StackTrace.GetFrames Método

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.StackTrace.dll

Origem:

StackTrace.cs

Retorna uma cópia de todos os quadros de pilha no rastreamento de pilha atual.

public:
 virtual cli::array <System::Diagnostics::StackFrame ^> ^ GetFrames();

public virtual System.Diagnostics.StackFrame[] GetFrames ();

abstract member GetFrames : unit -> System.Diagnostics.StackFrame[]
override this.GetFrames : unit -> System.Diagnostics.StackFrame[]

Public Overridable Function GetFrames () As StackFrame()

Retornos

StackFrame[]

Uma matriz do tipo StackFrame que representa as chamadas de função no rastreamento de pilha.

Exemplos

O exemplo de código a seguir demonstra a enumeração dos quadros em um StackTrace.

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() );

}

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

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

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

Comentários

Use a matriz retornada StackFrame para enumerar e examinar chamadas de função no StackTrace. O comprimento da matriz retornada é igual ao valor da FrameCount propriedade.

Os elementos da StackFrame matriz estão em ordem cronológica inversa. O StackFrame índice de matriz 0 representa a chamada de função mais recente no rastreamento de pilha e o último quadro enviado por push para a pilha de chamadas. O StackFrame índice FrameCount de matriz menos 1 representa a chamada de função mais antiga no rastreamento de pilha e o primeiro quadro enviado por push para a pilha de chamadas.

Use o GetFrames método para obter todos os quadros de pilha em um rastreamento de pilha; use o GetFrame método para obter um quadro de pilha específico em um rastreamento de pilha. Os StackFrame índices são ordenados de forma semelhante pelos dois métodos. Por exemplo, o StackFrame índice em 0 na matriz retornada por GetFrames é equivalente ao StackFrame retornado por GetFrame com um índice de entrada de 0.

Confira também

• StackFrame
• GetFrame(Int32)