Environment.StackTrace Propriété

Définition

Obtient les informations actuelles sur la trace de la pile.Gets current stack trace information.

public:
 static property System::String ^ StackTrace { System::String ^ get(); };
public static string StackTrace { get; }
member this.StackTrace : string
Public Shared ReadOnly Property StackTrace As String

Valeur de propriété

Chaîne contenant les informations de trace de la pile.A string containing stack trace information. Cette valeur peut être Empty.This value can be Empty.

Exemples

L’exemple suivant illustre la propriété StackTrace.The following example demonstrates the StackTrace property.

// 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
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 propriété StackTrace répertorie les appels de méthode dans l’ordre chronologique inverse, autrement dit, l’appel de méthode le plus récent est décrit en premier, et une ligne d’informations de trace de la pile est répertoriée pour chaque appel de méthode sur la pile.The StackTrace property lists method calls in reverse chronological order, that is, the most recent method call is described first, and one line of stack trace information is listed for each method call on the stack. Toutefois, la propriété StackTrace peut ne pas signaler autant d’appels de méthode que prévu en raison des transformations de code qui se produisent pendant l’optimisation.However, the StackTrace property might not report as many method calls as expected due to code transformations that occur during optimization.

Notes

Pour obtenir une vue hiérarchique des informations de trace de la pile par classe, utilisez la classe StackTrace.For a hierarchical view of the stack trace information by class, use the StackTrace class.

La propriété StackTrace met en forme les informations de trace de la pile pour chaque appel de méthode, comme suit :The StackTrace property formats the stack trace information for each method call as follows:

« à FullClassName. MethodName (MethodParams) dans FileName : ligne LineNumber »"at FullClassName.MethodName(MethodParams) in FileName :line LineNumber "

Le littéral « at » est précédé de trois espaces, et l’intégralité de la sous-chaîne commençant par « in » est omise si les symboles de débogage ne sont pas disponibles.The literal "at" is preceded by three spaces, and the entire substring starting with "in" is omitted if debug symbols are not available. Les espaces réservés, FullClassName, MethodName, MethodParams, FileName et LineNumber, sont remplacés par les valeurs réelles et sont définis comme suit :The placeholders, FullClassName, MethodName, MethodParams, FileName, and LineNumber, are replaced by actual values, and are defined as follows:

FullClassNameFullClassName
Nom complet de la classe, y compris l’espace de noms.The full name of the class, including the namespace.

MethodName
Nom de la méthode.The name of the method.

MethodParams
Liste de paires de type/nom de paramètre.The list of parameter type/name pairs. Chaque paire est séparée par une virgule (« , »).Each pair is separated by a comma (","). Ces informations sont omises si MethodName ne prend pas de paramètres.This information is omitted if MethodName takes no parameters.

FileName
Nom du fichier source dans lequel la méthode MethodName est déclarée.The name of the source file where the MethodName method is declared. Ces informations sont omises si les symboles de débogage ne sont pas disponibles.This information is omitted if debug symbols are not available.

LineNumber
Numéro de la ligne dans FileName qui contient le code source de MethodName pour l’instruction qui se trouve sur la pile des appels.The number of the line in FileName that contains the source code from MethodName for the instruction that is on the call stack. Ces informations sont omises si les symboles de débogage ne sont pas disponibles.This information is omitted if debug symbols are not available.

La chaîne Environment.NewLine met fin à chaque ligne de la trace de la pile.The Environment.NewLine string terminates each line of the stack trace.

Sécurité

EnvironmentPermission
pour un accès complet à la ressource protégée par l’autorisation.for full access to the resource protected by the permission. Énumération associée : UnrestrictedAssociated enumeration: Unrestricted

S’applique à