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

Определение

Возвращает текущие сведения о трассировке стека.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

Значение свойства

Строка, содержащая сведения о трассировке стека.A string containing stack trace information. Это значение может быть равно Empty.This value can be Empty.

Примеры

В следующем примере демонстрируется StackTrace свойство.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()'
'

Комментарии

StackTrace Свойство перечисляет вызовы метода в обратном хронологическом порядке, то есть сначала описан самый последний вызов метода одну строку сведений о трассировке стека в списке, а для каждого вызова метода в стеке.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. Тем не менее StackTrace свойство может сообщить столько предполагаемых вызовах методов из-за преобразований кода в процессе оптимизации.However, the StackTrace property might not report as many method calls as expected due to code transformations that occur during optimization.

Примечание

Иерархическое представление данные трассировки стека в классе, используйте StackTrace класса.For a hierarchical view of the stack trace information by class, use the StackTrace class.

StackTrace Свойство форматирует сведения о трассировке стека для каждого вызова метода, следующим образом:The StackTrace property formats the stack trace information for each method call as follows:

«в FullClassName.MethodName (MethodParams) в FileName : строки LineNumber ""at FullClassName.MethodName(MethodParams) in FileName :line LineNumber "

Литерал «на» предшествует три пробела, а вся подстрока, начиная с «in» пропускается в том случае, если символы отладки недоступны.The literal "at" is preceded by three spaces, and the entire substring starting with "in" is omitted if debug symbols are not available. Заполнители, FullClassName, MethodName, MethodParams, FileName, и LineNumber, заменяются фактическими значениями и определяются следующим образом:The placeholders, FullClassName, MethodName, MethodParams, FileName, and LineNumber, are replaced by actual values, and are defined as follows:

FullClassNameFullClassName
Полное имя класса, включая пространство имен.The full name of the class, including the namespace.

MethodName
Имя метода.The name of the method.

MethodParams
Список пар имен и типов параметров.The list of parameter type/name pairs. Каждая пара отделяется запятой («",»").Each pair is separated by a comma (","). Эта информация указывается, если MethodName не принимает никаких параметров.This information is omitted if MethodName takes no parameters.

FileName
Имя источника файла where MethodName метод объявляется.The name of the source file where the MethodName method is declared. Эта информация указывается, если символы отладки недоступны.This information is omitted if debug symbols are not available.

LineNumber
Номер строки в FileName , содержащий исходный код из MethodName для инструкции в стеке вызовов.The number of the line in FileName that contains the source code from MethodName for the instruction that is on the call stack. Эта информация указывается, если символы отладки недоступны.This information is omitted if debug symbols are not available.

Environment.NewLine Строка завершает каждой строки трассировки стека.The Environment.NewLine string terminates each line of the stack trace.

Безопасность

EnvironmentPermission
для полного доступа к ресурсу, защищенному с помощью разрешений.for full access to the resource protected by the permission. Связанное перечисление: UnrestrictedAssociated enumeration: Unrestricted

Применяется к