StackTrace.GetFrames Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.
