Environment.StackTrace Eigenschaft

Definition

Namespace:

System

Assembly:

System.Runtime.Extensions.dll

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

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 StackTrace Eigenschaft 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
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, also der neueste Methodenaufruf wird zuerst beschrieben, und eine Reihe von Stapelablaufverfolgungsinformationen wird für jeden Methodenaufruf im Stapel aufgelistet. Die Eigenschaft meldet jedoch möglicherweise aufgrund von Codetransformationen, die während der StackTrace Optimierung auftreten, möglicherweise nicht so viele Methodenaufrufe wie erwartet.

Hinweis

Verwenden Sie für eine hierarchische Ansicht der Stapelablaufverfolgungsinformationen nach Klasse die StackTrace Klasse.

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

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

Der 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, FileName``MethodName``MethodParamsund 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 nicht angegeben, wenn MethodName keine Parameter verwendet 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 FileName , die 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.