StackTrace Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa un seguimiento de pila, que es una colección ordenada de uno o varios marcos de pila.
public ref class StackTrace sealed
public ref class StackTrace
public sealed class StackTrace
public class StackTrace
[System.Serializable]
public class StackTrace
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StackTrace
type StackTrace = class
[<System.Serializable>]
type StackTrace = class
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StackTrace = class
Public NotInheritable Class StackTrace
Public Class StackTrace
- Herencia
-
StackTrace
- Atributos
Ejemplos
En la siguiente aplicación de consola se muestra cómo crear una StackTrace sencilla e iterar por sus fotogramas para obtener información de depuración y diagnóstico.
#using <System.dll>
using namespace System;
using namespace System::Diagnostics;
ref class StackTraceSample
{
private:
ref class MyInternalClass
{
public:
void ThrowsException()
{
try
{
throw gcnew Exception( "A problem was encountered." );
}
catch ( Exception^ e )
{
// Create a StackTrace that captures
// filename, line number, and column
// information for the current thread.
StackTrace^ st = gcnew StackTrace( true );
String^ stackIndent = "";
for ( int i = 0; i < st->FrameCount; i++ )
{
// Note that at this level, there are five
// stack frames, one for each method invocation.
StackFrame^ sf = st->GetFrame( i );
Console::WriteLine();
Console::WriteLine( "{0}Method: {1}", stackIndent, sf->GetMethod() );
Console::WriteLine( "{0}File: {1}", stackIndent, sf->GetFileName() );
Console::WriteLine( "{0}Line Number: {1}", stackIndent, sf->GetFileLineNumber().ToString() );
stackIndent = String::Concat( stackIndent, " " );
}
throw e;
}
}
};
protected:
void MyProtectedMethod()
{
MyInternalClass^ mic = gcnew MyInternalClass;
mic->ThrowsException();
}
public:
void MyPublicMethod()
{
MyProtectedMethod();
}
};
int main()
{
StackTraceSample^ sample = gcnew StackTraceSample;
try
{
sample->MyPublicMethod();
}
catch ( Exception^ )
{
// Create a StackTrace that captures
// filename, line number, and column
// information for the current thread.
StackTrace^ st = gcnew StackTrace( true );
for ( int i = 0; i < st->FrameCount; i++ )
{
// For an executable built from C++, there
// are two stack frames here: one for main,
// and one for the _mainCRTStartup stub.
StackFrame^ sf = st->GetFrame( i );
Console::WriteLine();
Console::WriteLine( "High up the call stack, Method: {0}", sf->GetMethod()->ToString() );
Console::WriteLine( "High up the call stack, Line Number: {0}", sf->GetFileLineNumber().ToString() );
}
}
}
/*
This console application produces the following output when
compiled with the Debug configuration.
Method: Void ThrowsException()
File: c:\samples\stacktraceframe\myclass.cpp
Line Number: 20
Method: Void MyProtectedMethod()
File: c:\samples\stacktraceframe\myclass.cpp
Line Number: 45
Method: Void MyPublicMethod()
File: c:\samples\stacktraceframe\myclass.cpp
Line Number: 50
Method: Int32 main()
File: c:\samples\stacktraceframe\myclass.cpp
Line Number: 56
Method: UInt32 _mainCRTStartup()
File:
Line Number: 0
High up the call stack, Method: Int32 main()
High up the call stack, Line Number: 62
High up the call stack, Method: UInt32 _mainCRTStartup()
High up the call stack, Line Number: 0
This console application produces the following output when
compiled with the Release configuration.
Method: Void ThrowsException()
File:
Line Number: 0
Method: Int32 main()
File:
Line Number: 0
Method: UInt32 _mainCRTStartup()
File:
Line Number: 0
High up the call stack, Method: Int32 main()
High up the call stack, Line Number: 0
High up the call stack, Method: UInt32 _mainCRTStartup()
High up the call stack, Line Number: 0
*/
using System;
using System.Diagnostics;
class StackTraceSample
{
[STAThread]
static void Main(string[] args)
{
StackTraceSample sample = new StackTraceSample();
try
{
sample.MyPublicMethod();
}
catch (Exception)
{
// Create a StackTrace that captures
// filename, line number, and column
// information for the current thread.
StackTrace st = new StackTrace(true);
for(int i =0; i< st.FrameCount; i++ )
{
// Note that high up the call stack, there is only
// one stack frame.
StackFrame sf = st.GetFrame(i);
Console.WriteLine();
Console.WriteLine("High up the call stack, Method: {0}",
sf.GetMethod());
Console.WriteLine("High up the call stack, Line Number: {0}",
sf.GetFileLineNumber());
}
}
}
public void MyPublicMethod ()
{
MyProtectedMethod();
}
protected void MyProtectedMethod ()
{
MyInternalClass mic = new MyInternalClass();
mic.ThrowsException();
}
class MyInternalClass
{
public void ThrowsException()
{
try
{
throw new Exception("A problem was encountered.");
}
catch (Exception e)
{
// Create a StackTrace that captures filename,
// line number and column information.
StackTrace st = new StackTrace(true);
string stackIndent = "";
for(int i =0; i< st.FrameCount; i++ )
{
// Note that at this level, there are four
// stack frames, one for each method invocation.
StackFrame sf = st.GetFrame(i);
Console.WriteLine();
Console.WriteLine(stackIndent + " Method: {0}",
sf.GetMethod() );
Console.WriteLine( stackIndent + " File: {0}",
sf.GetFileName());
Console.WriteLine( stackIndent + " Line Number: {0}",
sf.GetFileLineNumber());
stackIndent += " ";
}
throw e;
}
}
}
}
/*
This console application produces the following output when
compiled with the Debug configuration.
Method: Void ThrowsException()
File: c:\samples\stacktraceframe\myclass.cs
Line Number: 59
Method: Void MyProtectedMethod()
File: c:\samples\stacktraceframe\myclass.cs
Line Number: 45
Method: Void MyPublicMethod()
File: c:\samples\stacktraceframe\myclass.cs
Line Number: 39
Method: Void Main(System.String[])
File: c:\samples\stacktraceframe\myclass.cs
Line Number: 13
High up the call stack, Method: Void Main(System.String[])
High up the call stack, Line Number: 20
This console application produces the following output when
compiled with the Release configuration.
Method: Void ThrowsException()
File:
Line Number: 0
Method: Void Main(System.String[])
File:
Line Number: 0
High up the call stack, Method: Void Main(System.String[])
High up the call stack, Line Number: 0
*/
Imports System.Diagnostics
Class StackTraceSample
<STAThread()> _
Public Shared Sub Main()
Dim sample As New StackTraceSample()
Try
sample.MyPublicMethod()
Catch
' Create a StackTrace that captures
' filename, line number, and column
' information for the current thread.
Dim st As New StackTrace(True)
Dim i As Integer
For i = 0 To st.FrameCount - 1
' Note that high up the call stack, there is only
' one stack frame.
Dim sf As StackFrame = st.GetFrame(i)
Console.WriteLine()
Console.WriteLine("High up the call stack, Method: {0}", _
sf.GetMethod())
Console.WriteLine("High up the call stack, Line Number: {0}", _
sf.GetFileLineNumber())
Next i
End Try
End Sub
Public Sub MyPublicMethod()
MyProtectedMethod()
End Sub
Protected Sub MyProtectedMethod()
Dim mic As New MyInternalClass()
mic.ThrowsException()
End Sub
Class MyInternalClass
Public Sub ThrowsException()
Try
Throw New Exception("A problem was encountered.")
Catch e As Exception
' Create a StackTrace that captures filename,
' line number and column information.
Dim st As New StackTrace(True)
Dim stackIndent As String = ""
Dim i As Integer
For i = 0 To st.FrameCount - 1
' Note that at this level, there are four
' stack frames, one for each method invocation.
Dim sf As StackFrame = st.GetFrame(i)
Console.WriteLine()
Console.WriteLine(stackIndent + " Method: {0}", _
sf.GetMethod())
Console.WriteLine(stackIndent + " File: {0}", _
sf.GetFileName())
Console.WriteLine(stackIndent + " Line Number: {0}", _
sf.GetFileLineNumber())
stackIndent += " "
Next i
Throw e
End Try
End Sub
End Class
End Class
' This console application produces the following output when
' compiled with the Debug configuration.
'
' Method: Void ThrowsException()
' File: c:\pp\samples\stacktraceframe\myclass.vb
' Line Number: 55
'
' Method: Void MyProtectedMethod()
' File: c:\pp\samples\stacktraceframe\myclass.vb
' Line Number: 42
'
' Method: Void MyPublicMethod()
' File: c:\pp\samples\stacktraceframe\myclass.vb
' Line Number: 37
'
' Method: Void Main(System.String[])
' File: c:\pp\samples\stacktraceframe\myclass.vb
' Line Number: 13
'
' High up the call stack, Method: Void Main(System.String[])
' High up the call stack, Line Number: 18
'
'
' This console application produces the following output when
' compiled with the Release configuration.
'
' Method: Void ThrowsException()
' File:
' Line Number: 0
'
' Method: Void Main(System.String[])
' File:
' Line Number: 0
'
' High up the call stack, Method: Void Main()
' High up the call stack, Line Number: 0
'
Comentarios
StackTrace información será más informativa con las configuraciones de compilación de depuración. De forma predeterminada, las compilaciones de depuración incluyen símbolos de depuración, mientras que las compilaciones de versión no. Los símbolos de depuración contienen la mayoría de la información de archivo, nombre del método, número de línea y columna que se usa para construir objetos StackFrame y StackTrace.
StackTrace podría no notificar tantas llamadas de método como se esperaba, debido a las transformaciones de código que se producen durante la optimización.
Constructores
StackTrace() |
Inicializa una nueva instancia de la clase StackTrace desde el marco del autor de la llamada. |
StackTrace(Boolean) |
Inicializa una nueva instancia de la clase StackTrace desde el marco del autor de la llamada, capturando opcionalmente la información de origen. |
StackTrace(Exception, Boolean) |
Inicializa una nueva instancia de la clase StackTrace, utilizando el objeto de excepción proporcionado y capturando opcionalmente la información de origen. |
StackTrace(Exception, Int32, Boolean) |
Inicializa una nueva instancia de la clase StackTrace utilizando el objeto de excepción proporcionado, omitiendo el número especificado de fotogramas y capturando opcionalmente la información de origen. |
StackTrace(Exception, Int32) |
Inicializa una nueva instancia de la clase StackTrace mediante el objeto de excepción proporcionado y omite el número especificado de fotogramas. |
StackTrace(Exception) |
Inicializa una nueva instancia de la clase StackTrace mediante el objeto de excepción proporcionado. |
StackTrace(IEnumerable<StackFrame>) |
Construye un seguimiento de pila a partir de un conjunto de objetos StackFrame. |
StackTrace(Int32, Boolean) |
Inicializa una nueva instancia de la clase StackTrace desde el marco del autor de la llamada, omite el número especificado de fotogramas y, opcionalmente, captura la información de origen. |
StackTrace(Int32) |
Inicializa una nueva instancia de la clase StackTrace desde el marco del autor de la llamada, omitiendo el número especificado de fotogramas. |
StackTrace(StackFrame) |
Inicializa una nueva instancia de la clase StackTrace que contiene un solo marco. |
StackTrace(Thread, Boolean) |
Obsoletos.
Inicializa una nueva instancia de la clase StackTrace para un subproceso específico, capturando opcionalmente la información de origen. No use esta sobrecarga de constructor. |
Campos
METHODS_TO_SKIP |
Define el valor predeterminado para el número de métodos que se omitirán del seguimiento de la pila. Este campo es constante. |
Propiedades
FrameCount |
Obtiene el número de fotogramas del seguimiento de la pila. |
Métodos
Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
GetFrame(Int32) |
Obtiene el marco de pila especificado. |
GetFrames() |
Devuelve una copia de todos los marcos de pila del seguimiento de pila actual. |
GetHashCode() |
Actúa como función hash predeterminada. (Heredado de Object) |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
ToString() |
Crea una representación legible del seguimiento de la pila. |