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.

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

*/

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: