Environment.StackTrace Eigenschaft

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

Eigenschaftswert

Eine Zeichenfolge, die Stapelablaufverfolgungsinformationen enthält. Dieser Wert kann Empty sein.

Beispiele

Im folgenden Beispiel wird die StackTrace Eigenschaft veranschaulicht.

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

Hinweise

Die StackTrace Eigenschaft listet Methodenaufrufe in umgekehrter chronologischer Reihenfolge auf, d. h. der letzte Methodenaufruf wird zuerst beschrieben, und für jeden Methodenaufruf im Stapel wird eine Zeile mit Stapelüberwachungsinformationen aufgelistet. Die Eigenschaft meldet jedoch aufgrund von Codetransformationen, die während der StackTrace Optimierung auftreten, möglicherweise nicht so viele Methodenaufrufe wie erwartet.

Die StackTrace Eigenschaft formatiert die Stapelablaufverfolgungsinformationen für jeden Methodenaufruf wie folgt:

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

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

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

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 akzeptiert werden.

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

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

Die Environment.NewLine Zeichenfolge beendet jede Zeile der Stapelablaufverfolgung.