Environment.StackTrace Environment.StackTrace Environment.StackTrace Environment.StackTrace Property

Definition

Ruft die aktuellen Stapelüberwachungsinformationen ab.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

Eigenschaftswert

Eine Zeichenfolge, die Stapelüberwachungsinformationen enthält.A string containing stack trace information. Dieser Wert kann Empty sein.This value can be Empty.

Beispiele

Das folgende Beispiel zeigt die StackTrace Eigenschaft.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
Imports System

Class Sample
   Public Shared Sub Main()
      Console.WriteLine()
      Console.WriteLine("StackTrace: '{0}'", Environment.StackTrace)
   End Sub 'Main
End Class 'Sample
'
'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()'
'

Hinweise

Die StackTrace Eigenschaftenlisten Methodenaufrufe in umgekehrter chronologischer Reihenfolge, d. h. der letzte Methodenaufruf wird zunächst beschrieben und Stapelüberwachungsinformationen eine Zeile für jeden Aufruf einer Methode auf dem Stapel aufgelistet ist.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. Allerdings die StackTrace Eigenschaft meldet möglicherweise nicht wie erwartet, die auftreten, während der Optimierung so viele Methodenaufrufe.However, the StackTrace property might not report as many method calls as expected due to code transformations that occur during optimization.

Hinweis

Verwenden Sie für eine hierarchische Ansicht der Informationen der stapelüberwachung von-Klasse, die StackTrace Klasse.For a hierarchical view of the stack trace information by class, use the StackTrace class.

Die StackTrace -Eigenschaft formatiert die Stapelüberwachungsinformationen für jeden Aufruf einer Methode wie folgt:The StackTrace property formats the stack trace information for each method call as follows:

"am FullClassName.MethodName (MethodParams) in FileName : Zeile LineNumber ""at FullClassName.MethodName(MethodParams) in FileName :line LineNumber "

Das Literal "at" drei Leerzeichen vorangestellt ist, und die gesamte Teilzeichenfolge, beginnend mit "in" wird weggelassen, wenn keine Debugsymbole verfügbar sind.The literal "at" is preceded by three spaces, and the entire substring starting with "in" is omitted if debug symbols are not available. Die Platzhalter FullClassName, MethodName, MethodParams, FileName, und LineNumberdurch tatsächliche Werte ersetzt werden und sind wie folgt definiert:The placeholders, FullClassName, MethodName, MethodParams, FileName, and LineNumber, are replaced by actual values, and are defined as follows:

FullClassNameFullClassName
Der vollständige Name der Klasse, einschließlich des Namespaces.The full name of the class, including the namespace.

MethodName
Der Name der Methode.The name of the method.

MethodParams
Die Liste der Typnamen /-Parameterpaaren.The list of parameter type/name pairs. Jedes Paar wird getrennt durch ein Komma (",").Each pair is separated by a comma (","). Diese Informationen werden ausgelassen, wenn MethodName nimmt keine Parameter.This information is omitted if MethodName takes no parameters.

FileName
Der Name der Quelle der Datei, in der MethodName Methode deklariert ist.The name of the source file where the MethodName method is declared. Diese Informationen werden ausgelassen, wenn keine Debugsymbole verfügbar sind.This information is omitted if debug symbols are not available.

LineNumber
Die Nummer der Zeile im FileName , enthält den Quellcode aus MethodName für die Anweisung, die in der Aufrufliste befindet.The number of the line in FileName that contains the source code from MethodName for the instruction that is on the call stack. Diese Informationen werden ausgelassen, wenn keine Debugsymbole verfügbar sind.This information is omitted if debug symbols are not available.

Die Environment.NewLine Zeichenfolge beendet, wird jede Zeile der stapelüberwachung.The Environment.NewLine string terminates each line of the stack trace.

Sicherheit

EnvironmentPermission
für den Vollzugriff auf die durch die Berechtigung geschützte Ressource.for full access to the resource protected by the permission. Zugeordnete Enumeration: UnrestrictedAssociated enumeration: Unrestricted

Gilt für: