StackTrace.GetFrames StackTrace.GetFrames StackTrace.GetFrames StackTrace.GetFrames Method

Определение

Возвращает копию всех кадров стека в текущей трассировке стека.Returns a copy of all stack frames in the current stack trace.

public:
 virtual cli::array <System::Diagnostics::StackFrame ^> ^ GetFrames();
[System.Runtime.InteropServices.ComVisible(false)]
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()

Возвраты

Массив типа StackFrame, представляющий вызовы функции в трассировке стека.An array of type StackFrame representing the function calls in the stack trace.

Примеры

В следующем примере кода демонстрируется перечисление кадров в StackTrace.The following code example demonstrates enumerating the frames in a 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

Комментарии

Используйте возвращаемый StackFrame массив для перечисления и проверки вызовов функций StackTraceв.Use the returned StackFrame array to enumerate and examine function calls in the StackTrace. Длина возвращаемого массива равна FrameCount значению свойства.The length of the returned array is equal to the FrameCount property value.

Элементы StackFrame массива находятся в обратном хронологическом порядке.The StackFrame array elements are in reverse chronological order. StackFrame Индекс массива 0 представляет последний вызов функции в трассировке стека и последний кадр, помещенный в стек вызовов.The StackFrame at array index 0 represents the most recent function call in the stack trace and the last frame pushed onto the call stack. StackFrame ИндексFrameCount массива минус 1 представляет самый старый вызов функции в трассировке стека и первый кадр, помещенный в стек вызовов.The StackFrame at array index FrameCount minus 1 represents the oldest function call in the stack trace and the first frame pushed onto the call stack.

Используйте метод для получения всех кадров стека в трассировке стека; GetFrame используйте метод для получения определенного кадра стека в трассировке стека. GetFramesUse the GetFrames method to obtain all stack frames in a stack trace; use the GetFrame method to obtain a specific stack frame in a stack trace. StackFrame Индексы упорядочиваются с одинаковыми двумя методами.The StackFrame indexes are ordered alike by the two methods. Например, StackFrame индекс 0 в массиве, возвращенном методом GetFrames , GetFrame эквивалентен StackFrame возвращаемому с входным индексом 0.For example, the StackFrame at index 0 in the array returned by GetFrames is equivalent to the StackFrame returned by GetFrame with an input index of 0.

Применяется к

Дополнительно