Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase StackTrace

 

Publicado: octubre de 2016

Representa un seguimiento de pila, que es una colección ordenada de uno o más marcos de pila.

Espacio de nombres:   System.Diagnostics
Ensamblado:  mscorlib (en mscorlib.dll)

System.Object
  System.Diagnostics.StackTrace

<SerializableAttribute>
<ComVisibleAttribute(True)>
<SecurityPermissionAttribute(SecurityAction.InheritanceDemand,
	UnmanagedCode := True)>
Public Class StackTrace

NombreDescripción
System_CAPS_pubmethodStackTrace()

Inicializa una nueva instancia de la StackTrace clase a partir del marco del llamador.

System_CAPS_pubmethodStackTrace(Boolean)

Inicializa una nueva instancia de la StackTrace clase a partir del marco del llamador, opcionalmente, captura información de origen.

System_CAPS_pubmethodStackTrace(Exception)

Inicializa una nueva instancia de la StackTrace clase utilizando el objeto de excepción proporcionado.

System_CAPS_pubmethodStackTrace(Exception, Boolean)

Inicializa una nueva instancia de la StackTrace (clase), utilizando el objeto de excepción que se suministra y, opcionalmente, captura información de origen.

System_CAPS_pubmethodStackTrace(Exception, Int32)

Inicializa una nueva instancia de la StackTrace de clase con el objeto de excepción proporcionado y omitir el número especificado de fotogramas.

System_CAPS_pubmethodStackTrace(Exception, Int32, Boolean)

Inicializa una nueva instancia de la StackTrace clase utilizando el objeto de excepción que se suministra, omite el número de marcos especificado y, opcionalmente, captura información de origen.

System_CAPS_pubmethodStackTrace(Int32)

Inicializa una nueva instancia de la StackTrace clase a partir del marco del llamador, omite el número especificado de fotogramas.

System_CAPS_pubmethodStackTrace(Int32, Boolean)

Inicializa una nueva instancia de la StackTrace clase a partir del marco del llamador, se omitirá el número de marcos especificado y, opcionalmente, captura información de origen.

System_CAPS_pubmethodStackTrace(StackFrame)

Inicializa una nueva instancia de la StackTrace clase que contiene un solo marco.

System_CAPS_pubmethodStackTrace(Thread, Boolean)

Obsoleto. Inicializa una nueva instancia de la StackTrace clase para un subproceso específico y, opcionalmente, captura información de origen.

No utilice esta sobrecarga del constructor.

NombreDescripción
System_CAPS_pubpropertyFrameCount

Obtiene el número de marcos en el seguimiento de pila.

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetFrame(Int32)

Obtiene el marco de pila especificado.

System_CAPS_pubmethodGetFrames()

Devuelve una copia de todos los marcos de pila en el seguimiento de pila actual.

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodToString()

Compila una representación legible del seguimiento de pila.(Invalida Object.ToString()).

NombreDescripción
System_CAPS_pubfieldSystem_CAPS_staticMETHODS_TO_SKIP

Define el valor predeterminado para el número de métodos para omitir desde el seguimiento de pila. Este campo es constante.

StackTrace información será más descriptiva con configuraciones de compilación de depuración. De forma predeterminada, las versiones de depuración incluyen símbolos de depuración, mientras que las versiones de lanzamiento no. Los símbolos de depuración contienen la mayoría de los archivo, el nombre del método, el número de línea y la información de columna que se utiliza para construir StackFrame y StackTrace objetos.

StackTrace no puede informar de las llamadas a métodos como se esperaba, debido a las transformaciones de código que se producen durante la optimización.

La siguiente aplicación de consola muestra cómo crear un sencillo StackTrace y recorrer en iteración sus marcos para obtener información de depuración y diagnóstico.

Imports System
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
'

InheritanceDemand

for the ability of inheritors to access unmanaged code. Associated enumeration: F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode. This class cannot be inherited by partially trusted code.

Plataforma universal de Windows
Disponible desde 10
.NET Framework
Disponible desde 1.1
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: