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 ref 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.

#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

*/

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: