StackTrace.GetFrames Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve uma cópia de todos os frames de pilha no rastreio de pilha atual.
public:
cli::array <System::Diagnostics::StackFrame ^> ^ GetFrames();
public:
virtual cli::array <System::Diagnostics::StackFrame ^> ^ GetFrames();
public System.Diagnostics.StackFrame[] GetFrames();
[System.Runtime.InteropServices.ComVisible(false)]
public virtual System.Diagnostics.StackFrame[] GetFrames();
public virtual System.Diagnostics.StackFrame[] GetFrames();
member 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[]
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()
Devoluções
Um array de tipos StackFrame que representa as chamadas de função no traço de pilha.
- Atributos
Exemplos
O seguinte exemplo de código demonstra enumerar os frames num StackTrace.
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
Observações
Use o array devolvido StackFrame para enumerar e examinar chamadas de funções no StackTrace. O comprimento do array devolvido é igual ao valor da FrameCount propriedade.
Os StackFrame elementos do array estão em ordem cronológica inversa. O StackFrame índice at do array 0 representa a chamada de função mais recente no traço da pilha e o último frame empurrado para a pilha de chamadas. O StackFrame índice FrameCount at do array menos 1 representa a chamada de função mais antiga no traço da pilha e o primeiro frame empurrado para a pilha de chamadas.
Use o GetFrames método para obter todos os frames de pilha num rastreio de pilha; use o GetFrame método para obter um quadro de pilha específico num trilho de pilha. Os StackFrame índices estão ordenados de forma semelhante pelos dois métodos. Por exemplo, o StackFrame no índice 0 no array devolvido por GetFrames é equivalente ao StackFrame devolvido por GetFrame com um índice de entrada 0.