Environment.StackTrace 属性

定义

命名空间:

System

程序集:

netstandard.dll, System.Runtime.dll

Source:

Environment.cs

获取当前堆栈跟踪信息。

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

属性值

String

包含堆栈跟踪信息的字符串。 此值可为 Empty。

示例

下面的示例演示了该 StackTrace 属性。

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

注解

属性 StackTrace 按反向时间顺序列出方法调用，即首先描述最新的方法调用，并且为堆栈上的每个方法调用列出一行堆栈跟踪信息。 但是，由于优化期间发生的代码转换，该 StackTrace 属性可能不会报告尽可能多的方法调用。

注释

对于按类划分的堆栈跟踪信息的分层视图，请使用该 StackTrace 类。

属性 StackTrace 设置每个方法调用的堆栈跟踪信息的格式，如下所示：

“at FullClassName.MethodName（MethodParams） in FileName ：line LineNumber ”

文本“at”前面有三个空格，如果调试符号不可用，则忽略以“in”开头的整个子字符串。 占位符、 FullClassName、 MethodName、 MethodParams和 FileName占 LineNumber位符由实际值替换，定义如下：

FullClassName 类的完整名称，包括命名空间。

MethodName 方法的名称。

MethodParams 参数类型/名称对的列表。 每对用逗号（“，”）分隔。 如果没有 MethodName 参数，则会省略此信息。

FileName 声明方法的 MethodName 源文件的名称。 如果调试符号不可用，则会省略此信息。

LineNumber 包含 FileName 调用堆栈上的指令的源代码 MethodName 的行号。 如果调试符号不可用，则会省略此信息。

字符串 Environment.NewLine 将终止堆栈跟踪的每一行。