Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

StackTrace classe

 

Date de publication : novembre 2016

Représente une trace de pile, qui est une collection ordonnée d’un ou plusieurs frames de pile.

Espace de noms:   System.Diagnostics
Assembly:  mscorlib (dans mscorlib.dll)

System.Object
  System.Diagnostics.StackTrace

[SerializableAttribute]
[ComVisibleAttribute(true)]
[SecurityPermissionAttribute(SecurityAction.InheritanceDemand, 
	UnmanagedCode = true)]
public class StackTrace

NomDescription
System_CAPS_pubmethodStackTrace()

Initialise une nouvelle instance de la StackTrace classe frame de l’appelant.

System_CAPS_pubmethodStackTrace(Boolean)

Initialise une nouvelle instance de la StackTrace classe du frame de l’appelant, en capturant éventuellement les informations sur la source.

System_CAPS_pubmethodStackTrace(Exception)

Initialise une nouvelle instance de la StackTrace classe à l’aide de l’objet exception fourni.

System_CAPS_pubmethodStackTrace(Exception, Boolean)

Initialise une nouvelle instance de la StackTrace (classe), à l’aide de l’objet exception fourni et en capturant éventuellement les informations sur la source.

System_CAPS_pubmethodStackTrace(Exception, Int32)

Initialise une nouvelle instance de la StackTrace de classe à l’aide de l’objet exception fourni et en ignorant le nombre spécifié de frames.

System_CAPS_pubmethodStackTrace(Exception, Int32, Boolean)

Initialise une nouvelle instance de la StackTrace de classes à l’aide de l’objet exception fourni, en ignorant le nombre spécifié de frames et en capturant éventuellement les informations sur la source.

System_CAPS_pubmethodStackTrace(Int32)

Initialise une nouvelle instance de la StackTrace classe du frame de l’appelant, en ignorant le nombre spécifié de frames.

System_CAPS_pubmethodStackTrace(Int32, Boolean)

Initialise une nouvelle instance de la StackTrace classe du frame de l’appelant, en ignorant le nombre spécifié de frames et en capturant éventuellement les informations sur la source.

System_CAPS_pubmethodStackTrace(StackFrame)

Initialise une nouvelle instance de la StackTrace classe qui contient une seule image.

System_CAPS_pubmethodStackTrace(Thread, Boolean)

Obsolète. Initialise une nouvelle instance de la StackTrace classe pour un thread spécifique, en capturant éventuellement les informations sur la source.

N’utilisez pas cette surcharge de constructeur.

NomDescription
System_CAPS_pubpropertyFrameCount

Obtient le nombre de frames dans la trace de pile.

NomDescription
System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetFrame(Int32)

Obtient le frame de pile spécifié.

System_CAPS_pubmethodGetFrames()

Retourne une copie de tous les frames de pile dans la trace de pile en cours.

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodToString()

Génère une représentation lisible de la trace de la pile.(Remplace Object.ToString().)

NomDescription
System_CAPS_pubfieldSystem_CAPS_staticMETHODS_TO_SKIP

Définit la valeur par défaut pour le nombre de méthodes à omettre dans la trace de pile. Ce champ est constant.

StackTrace informations seront encore plus informatives avec des configurations de build Debug. Par défaut, les versions Debug incluent des symboles de débogage, contrairement aux versions Release. Les symboles de débogage contiennent la plupart des fichiers, nom de la méthode, numéro de ligne, les informations sur les colonnes utilisées dans la construction StackFrame et StackTrace objets.

StackTrace peut ne pas rapporter autant d’appels de méthode comme prévu, en raison des transformations de code qui se produisent pendant l’optimisation.

L’application console suivante montre comment créer une simple StackTrace et parcourir ses frames pour obtenir des informations de débogage et de Diagnostics.

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.

Plateforme Windows universelle
Disponible depuis 10
.NET Framework
Disponible depuis 1.1
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: