Compartilhar via


StackTrace.GetFrames Método

Definição

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

public:
 cli::array <System::Diagnostics::StackFrame ^> ^ GetFrames();
public:
 virtual cli::array <System::Diagnostics::StackFrame ^> ^ GetFrames();
public System.Diagnostics.StackFrame[] GetFrames ();
public virtual System.Diagnostics.StackFrame[] GetFrames ();
public virtual System.Diagnostics.StackFrame?[] GetFrames ();
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Diagnostics.StackFrame[] GetFrames ();
member this.GetFrames : unit -> System.Diagnostics.StackFrame[]
abstract member GetFrames : unit -> System.Diagnostics.StackFrame[]
override this.GetFrames : unit -> System.Diagnostics.StackFrame[]
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member GetFrames : unit -> System.Diagnostics.StackFrame[]
override this.GetFrames : unit -> System.Diagnostics.StackFrame[]
Public Function GetFrames () As StackFrame()
Public Overridable Function GetFrames () As StackFrame()

Retornos

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

Atributos

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.

Aplica-se a

Confira também