Environment.StackTrace Propriété

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Source:

Environment.cs

Obtient les informations actuelles sur la trace de la pile.

public:
 static property System::String ^ StackTrace { System::String ^ get(); };

public static string StackTrace { get; }

static member StackTrace : string

Public Shared ReadOnly Property StackTrace As String

Valeur de propriété

String

Chaîne contenant les informations de trace de la pile. Cette valeur peut être Empty.

Exemples

L’exemple suivant illustre la StackTrace propriété .

// Sample for the Environment::StackTrace property
using namespace System;
int main()
{
   Console::WriteLine();
   Console::WriteLine( "StackTrace: ' {0}'", Environment::StackTrace );
}

/*
This example produces the following results:

StackTrace: '   at System::Environment::GetStackTrace(Exception e)
at System::Environment::GetStackTrace(Exception e)
at System::Environment::get_StackTrace()
at Sample::Main()'
*/

// Sample for the Environment.StackTrace property
using System;

class Sample
{
    public static void Main()
    {
    Console.WriteLine();
    Console.WriteLine("StackTrace: '{0}'", Environment.StackTrace);
    }
}
/*
This example produces the following results:

StackTrace: '   at System.Environment.GetStackTrace(Exception e)
   at System.Environment.GetStackTrace(Exception e)
   at System.Environment.get_StackTrace()
   at Sample.Main()'
*/

// Sample for the Environment.StackTrace property
open System

printfn $"\nStackTrace: '{Environment.StackTrace}'"

// This example produces the following results:
//     StackTrace: '   at System.Environment.GetStackTrace(Exception e)
//        at System.Environment.GetStackTrace(Exception e)
//        at System.Environment.get_StackTrace()
//        at <StartupCode$fs>.$Stacktrace.main@()'

' Sample for the Environment.StackTrace property
Class Sample
   Public Shared Sub Main()
      Console.WriteLine()
      Console.WriteLine("StackTrace: '{0}'", Environment.StackTrace)
   End Sub
End Class
'
'This example produces the following results:
'
'StackTrace: '   at System.Environment.GetStackTrace(Exception e)
'   at System.Environment.GetStackTrace(Exception e)
'   at System.Environment.get_StackTrace()
'   at Sample.Main()'
'

Remarques

La StackTrace propriété répertorie les appels de méthode dans l’ordre chronologique inverse, c’est-à-dire que l’appel de méthode le plus récent est décrit en premier et qu’une ligne d’informations de trace de pile est répertoriée pour chaque appel de méthode sur la pile. Toutefois, la StackTrace propriété peut ne pas signaler autant d’appels de méthode que prévu en raison de transformations de code qui se produisent pendant l’optimisation.

Notes

Pour obtenir une vue hiérarchique des informations de trace de pile par classe, utilisez la StackTrace classe .

La StackTrace propriété met en forme les informations de trace de pile pour chaque appel de méthode comme suit :

« à FullClassName.MethodName(MethodParams) dans FileName :line LineNumber »

Le littéral « at » est précédé de trois espaces, et la sous-chaîne entière commençant par « in » est omise si les symboles de débogage ne sont pas disponibles. Les espaces réservés, FullClassName, MethodName, MethodParams, FileNameet LineNumber, sont remplacés par des valeurs réelles et sont définis comme suit :

FullClassName Nom complet de la classe, y compris l’espace de noms.

MethodName Nom de la méthode.

MethodParams Liste des paires type/nom de paramètre. Chaque paire est séparée par une virgule (« , »). Ces informations sont omises si MethodName ne prend aucun paramètre.

FileName Nom du fichier source dans lequel la MethodName méthode est déclarée. Ces informations sont omises si les symboles de débogage ne sont pas disponibles.

LineNumber Numéro de la ligne dans FileName laquelle contient le code source de MethodName l’instruction qui se trouve sur la pile des appels. Ces informations sont omises si les symboles de débogage ne sont pas disponibles.

La Environment.NewLine chaîne termine chaque ligne de la trace de pile.