Environment.StackTrace Eigenschaft

Definition

Ruft die aktuellen Stapelüberwachungsinformationen ab.

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

String

Eine Zeichenfolge, die Stapelüberwachungsinformationen enthält. Dieser Wert kann Empty sein.

Beispiele

Im folgenden Beispiel wird die -Eigenschaft StackTrace veranschaulicht.

// 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()'
'

Hinweise

Die -Eigenschaft listet Methodenaufrufe in umgekehrter chronologischer Reihenfolge auf. Das heißt, der letzte Methodenaufruf wird zuerst beschrieben, und für jeden Methodenaufruf im Stapel wird eine Zeile stapelüberwachungsinformationen StackTrace aufgelistet. Die -Eigenschaft kann jedoch aufgrund von Codetransformationen, die während der Optimierung auftreten, nicht so viele Methodenaufrufe StackTrace wie erwartet melden.

Hinweis

Verwenden Sie für eine hierarchische Ansicht der Stapelüberwachungsinformationen nach Klasse die StackTrace -Klasse.

Die StackTrace -Eigenschaft formatiert die Stapelüberwachungsinformationen für jeden Methodenaufruf wie folgt:

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

Dem Literal "at" werden drei Leerzeichen voran gestellt, und die gesamte Teilzeichenfolge, die mit "in" beginnt, wird weggelassen, wenn keine Debugsymbole verfügbar sind. Die Platzhalter , , , und werden durch tatsächliche Werte ersetzt FullClassName MethodName und wie folgt MethodParams FileName LineNumber definiert:

FullClassName Der vollständige Name der Klasse, einschließlich des Namespace.

MethodName Der Name der Methode.

MethodParams Die Liste der Parametertyp-Name-Paare. Jedes Paar wird durch ein Komma (",") getrennt. Diese Informationen werden weggelassen, wenn MethodName keine Parameter verwendet.

FileName Der Name der Quelldatei, in der MethodName die Methode deklariert wird. Diese Informationen werden weggelassen, wenn keine Debugsymbole verfügbar sind.

LineNumber Die Nummer der Zeile in , die den Quellcode von für die Anweisung FileName MethodName enthält, die sich in der Aufrufliste befindet. Diese Informationen werden weggelassen, wenn keine Debugsymbole verfügbar sind.

Die Environment.NewLine Zeichenfolge beendet jede Zeile der Stapelüberwachung.

Gilt für