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 StackFrame

 

Publicado: octubre de 2016

Proporciona información sobre un StackFrame, que representa una llamada de función en la pila de llamadas del subproceso actual.

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

System.Object
  System.Diagnostics.StackFrame

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

NombreDescripción
System_CAPS_pubmethodStackFrame()

Inicializa una nueva instancia de la clase StackFrame.

System_CAPS_pubmethodStackFrame(Boolean)

Inicializa una nueva instancia de la clase StackFrame, mientras se inicializa la propiedad, y opcionalmente captura información de origen.

System_CAPS_pubmethodStackFrame(Int32)

Inicializa una nueva instancia de la clase StackFrame que corresponde a un marco situado encima del marco de pila actual.

System_CAPS_pubmethodStackFrame(Int32, Boolean)

Inicializa una nueva instancia de la clase StackFrame que corresponde a un marco situado encima del marco de pila actual, y opcionalmente captura información de origen.

System_CAPS_pubmethodStackFrame(String, Int32)

Inicializa una nueva instancia de la clase StackFrame que contiene únicamente el nombre de archivo y el número de línea especificados.

System_CAPS_pubmethodStackFrame(String, Int32, Int32)

Inicializa una nueva instancia de la clase StackFrame que contiene únicamente el nombre de archivo, el número de línea y el número de columna especificados.

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_pubmethodGetFileColumnNumber()

Obtiene el número de columna del archivo que contiene el código que se está ejecutando. Esta información se extrae normalmente de los símbolos de depuración del ejecutable.

System_CAPS_pubmethodGetFileLineNumber()

Obtiene el número de línea del archivo que contiene el código que se está ejecutando. Esta información se extrae normalmente de los símbolos de depuración del ejecutable.

System_CAPS_pubmethodGetFileName()

Obtiene el nombre de archivo que contiene el código que se está ejecutando. Esta información se extrae normalmente de los símbolos de depuración del ejecutable.

System_CAPS_pubmethodGetHashCode()

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

System_CAPS_pubmethodGetILOffset()

Obtiene el desplazamiento desde el inicio del código del Lenguaje intermedio de Microsoft (MSIL) del método que se está ejecutando. Este desplazamiento puede ser aproximado en función de si el compilador Just-In-Time (JIT) está generando código de depuración. La generación de esta información de depuración está controlada por DebuggableAttribute.

System_CAPS_pubmethodGetMethod()

Obtiene el método en el que se está ejecutando el marco.

System_CAPS_pubmethodGetNativeOffset()

Obtiene el desplazamiento desde el inicio del código nativo de compilación Just-In-Time (JIT) del método que se está ejecutando. La generación de esta información de depuración está controlada por la clase DebuggableAttribute.

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_staticOFFSET_UNKNOWN

Define el valor que se devuelve desde el método GetNativeOffset o GetILOffset cuando se desconoce el desplazamiento nativo o de Lenguaje Intermedio de Microsoft (MSIL). Este campo es constante.

Un StackFrame se crea y se inserta en la pila de llamadas para cada llamada de función realizada durante la ejecución de un subproceso. El marco de pila siempre incluye MethodBase información y, opcionalmente, incluye el nombre de archivo, el número de línea y la información de número de columna.

StackFrame 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 objetos.

En el ejemplo siguiente se muestra el uso de la StackFrame clase para proporcionar la información de marco de pila para un seguimiento de pila.

Imports System
Imports System.Diagnostics



Class Program

    Shared Sub Main(ByVal args() As String)
        Try
            Method1()
        Catch e As Exception
            Dim st As New StackTrace()
            Dim st1 As New StackTrace(New StackFrame(True))
            Console.WriteLine(" Stack trace for Main: {0}", st1.ToString())
            Console.WriteLine(st.ToString())
        End Try
        Console.WriteLine("Press Enter to exit.")
        Console.ReadLine()

    End Sub 'Main

    Private Shared Sub Method1()
        Try
            Method2(4)
        Catch e As Exception
            Dim st As New StackTrace()
            Dim st1 As New StackTrace(New StackFrame(True))
            Console.WriteLine(" Stack trace for Method1: {0}", st1.ToString())
            Console.WriteLine(st.ToString())
            ' Build a stack trace for the next frame.
            Dim st2 As New StackTrace(New StackFrame(1, True))
            Console.WriteLine(" Stack trace for next level frame: {0}", st2.ToString())
            Throw e
        End Try

    End Sub 'Method1

    Private Shared Sub Method2(ByVal count As Integer)
        Try
            If count < 5 Then
                Throw New ArgumentException("count too large", "count")
            End If
        Catch e As Exception
            Dim st As New StackTrace()
            Dim st1 As New StackTrace(New StackFrame(2, True))
            Console.WriteLine(" Stack trace for Method2: {0}", st1.ToString())
            Console.WriteLine(st.ToString())
            Throw e
        End Try

    End Sub 'Method2
End Class 'Program

En el ejemplo siguiente se muestra el uso de los miembros de la StackFrame clase.

Imports System
Imports System.Diagnostics

Imports SampleInternal

Namespace SamplePublic

   ' This console application illustrates various uses
   ' of the StackTrace and StackFrame classes.

   Class ConsoleApp

      <STAThread()>  _
      Shared Sub Main()
         Dim mainClass As New ClassLevel1

         Try
            mainClass.InternalMethod()
         Catch
            Console.WriteLine(" Main method exception handler")

            ' Display file and line information, if available.
            Dim st As New StackTrace(New StackFrame(True))
            Console.WriteLine(" Stack trace for current level: {0}", _
               st.ToString())
            Console.WriteLine(" File: {0}", _
               st.GetFrame(0).GetFileName())
            Console.WriteLine(" Line Number: {0}", _
               st.GetFrame(0).GetFileLineNumber().ToString())

            Console.WriteLine()
            Console.WriteLine("-------------------------------------------------")
            Console.WriteLine()
         End Try
      End Sub 'Main
   End Class 'ConsoleApp
End Namespace 'StackFramePublic 

Namespace SampleInternal

   Public Class ClassLevel1

      Public Sub InternalMethod()
         Try
            Dim nestedClass As New ClassLevel2
            nestedClass.Level2Method()
         Catch e As Exception
            Console.WriteLine(" InternalMethod exception handler")

            ' Build a stack trace from one frame, skipping the 
            ' current frame and using the next frame.  By default,
            ' file and line information are not displayed.
            Dim st As New StackTrace(New StackFrame(1))
            Console.WriteLine(" Stack trace for next level frame: {0}", _
               st.ToString())
            Console.WriteLine(" Stack frame for next level: ")
            Console.WriteLine("   {0}", st.GetFrame(0).ToString())

            Console.WriteLine(" Line Number: {0}", _
               st.GetFrame(0).GetFileLineNumber().ToString())

            Console.WriteLine()
            Console.WriteLine("   ... throwing exception to next level ...")
            Console.WriteLine("-------------------------------------------------")
            Console.WriteLine()
            Throw e
         End Try
      End Sub 'InternalMethod
   End Class 'ClassLevel1

   Public Class ClassLevel2

      Public Sub Level2Method()
         Try
            Dim nestedClass As New ClassLevel3
            nestedClass.Level3Method()

         Catch e As Exception
            Console.WriteLine(" Level2Method exception handler")

            ' Display the full call stack at this level.
            Dim st1 As New StackTrace(True)
            Console.WriteLine(" Stack trace for this level: {0}", _
               st1.ToString())

            ' Build a stack trace from one frame, skipping the current
            ' frame and using the next frame.
            Dim st2 As New StackTrace(New StackFrame(1, True))
            Console.WriteLine(" Stack trace built with next level frame: {0}", _
                st2.ToString())

            ' Build a stack trace skipping the current frame, and
            ' including all the other frames.
            Dim st3 As New StackTrace(1, True)
            Console.WriteLine(" Stack trace built from the next level up: {0}", _
                st3.ToString())

            Console.WriteLine()
            Console.WriteLine("   ... throwing exception to next level ...")
            Console.WriteLine("-------------------------------------------------")
            Console.WriteLine()
            Throw e
         End Try
      End Sub 'Level2Method
   End Class 'ClassLevel2

   Public Class ClassLevel3

      Public Sub Level3Method()
         Try
            Dim nestedClass As New ClassLevel4()
            nestedClass.Level4Method()
         Catch e As Exception
            Console.WriteLine(" Level3Method exception handler")

            ' Build a stack trace from a dummy stack frame.
            ' Explicitly specify the source file name and line number.
            Dim st As New StackTrace(New StackFrame("source.cs", 60))
            Console.WriteLine(" Stack trace with dummy stack frame: {0}", _
               st.ToString())
            Dim i As Integer
            For i = 0 To st.FrameCount - 1
               ' Display the stack frame properties.
               Dim sf As StackFrame = st.GetFrame(i)
               Console.WriteLine(" File: {0}", sf.GetFileName())
               Console.WriteLine(" Line Number: {0}", _
                  sf.GetFileLineNumber())
               ' The column number defaults to zero when not initialized.
               Console.WriteLine(" Column Number: {0}", _
                  sf.GetFileColumnNumber())
               If sf.GetILOffset <> StackFrame.OFFSET_UNKNOWN
                  Console.WriteLine(" Intermediate Language Offset: {0}", _
                      sf.GetILOffset())
               End If
               If sf.GetNativeOffset <> StackFrame.OFFSET_UNKNOWN
                 Console.WriteLine(" Native Offset: {0}", _
                     sf.GetNativeOffset())
               End If
            Next i 
            Console.WriteLine()
            Console.WriteLine("   ... throwing exception to next level ...")
            Console.WriteLine("-------------------------------------------------")
            Console.WriteLine()
            Throw e
         End Try
      End Sub 'Level3Method
   End Class 'ClassLevel3

   Public Class ClassLevel4

      Public Sub Level4Method()
         Try
            Dim [nestedClass] As New ClassLevel5()
            [nestedClass].Level5Method()
         Catch e As Exception
            Console.WriteLine(" Level4Method exception handler")

            ' Build a stack trace from a dummy stack frame.
            ' Explicitly specify the source file name, line number
            ' and column number.
            Dim st As New StackTrace(New StackFrame("source.cs", 79, 24))
            Console.WriteLine(" Stack trace with dummy stack frame: {0}", _
               st.ToString())

            ' Access the StackFrames explicitly to display the file
            ' name, line number and column number properties.
            ' StackTrace.ToString only includes the method name. 
            Dim i As Integer
            For i = 0 To st.FrameCount - 1
               Dim sf As StackFrame = st.GetFrame(i)
               Console.WriteLine(" File: {0}", sf.GetFileName())
               Console.WriteLine(" Line Number: {0}", _
                  sf.GetFileLineNumber())
               Console.WriteLine(" Column Number: {0}", _
                  sf.GetFileColumnNumber())
            Next i
            Console.WriteLine()
            Console.WriteLine("   ... throwing exception to next level ...")
            Console.WriteLine("-------------------------------------------------")
            Console.WriteLine()
            Throw e
         End Try
      End Sub 'Level4Method 
   End Class 'ClassLevel4


   Public Class ClassLevel5

      Public Sub Level5Method()
         Try
            Dim nestedClass As New ClassLevel6()
            nestedClass.Level6Method()
         Catch e As Exception
            Console.WriteLine(" Level5Method exception handler")

            Dim st As New StackTrace()

            ' Display the most recent function call.
            Dim sf As StackFrame = st.GetFrame(0)
            Console.WriteLine()
            Console.WriteLine("  Exception in method: ")
            Console.WriteLine("      {0}", sf.GetMethod())

            If st.FrameCount > 1 Then
               ' Display the highest-level function call in the trace.
               sf = st.GetFrame((st.FrameCount - 1))
               Console.WriteLine("  Original function call at top of call stack):")
               Console.WriteLine("      {0}", sf.GetMethod())
            End If

            Console.WriteLine()
            Console.WriteLine("   ... throwing exception to next level ...")
            Console.WriteLine("-------------------------------------------------")
            Console.WriteLine()
            Throw e
         End Try
      End Sub 'Level5Method
   End Class 'ClassLevel5 


   Public Class ClassLevel6
      Public Sub Level6Method()
         Throw New Exception("An error occurred in the lowest internal class method.")
      End Sub 'Level6Method
   End Class 'ClassLevel6 

End Namespace 'StackFrameInternal

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: