Свойство My.Application.Info.StackTrace

Статья
11/05/2008

Обновлен: Ноябрь 2007

Получает текущие сведения о трассировке стека.

' Usage
Dim value As String = My.Application.Info.StackTrace
' Declaration
Public ReadOnly Property StackTrace As String

Возвращаемое значение

String, содержащая текущие сведения о трассировке стека. Empty является допустимым вовзращаемым значением.

Исключения

Следующее условие может вызывать исключение.

Запрошенные сведения о трассировке стека находятся вне диапазона (ArgumentOutOfRangeException).

Заметки

Свойство My.Application.Info.StackTrace перечисляет вызовы метода в обратном хронологическом порядке, т. е. оно описывает самые последние вызовы метода в самом начале и в нем перечислены все вызовы метода в стеке в отдельной строке. Однако свойство My.Application.Info.StackTrace может сообщить о меньшем количестве вызовов, чем ожидается из-за изменений, происходящих с кодом во время оптимизации.

Обычно информация о трассировке стека используется для отладки приложений.

Сведения о трассировке стека для каждого вызова метода имеют следующий формат:

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

Литералу "at" предшествуют три пробела, а литералы "in" и ":line" пропускаются, если недоступны символы отладки. Замещающие символы FullClassName, MethodName, MethodParams, FileName и LineNumber заменяются фактическими значениями, определенными следующим образом:

Часть	Описание
FullClassName	Полное имя класса, включающее пространство имен.
MethodName	Имя метода.
MethodParams	Список пар имен и типов параметра. Каждая пара отделяется запятой (,). Эти сведения пропускаются, если MethodName принимает нулевые параметры.
FileName	Имя файла-источника, в котором объявлен метод MethodName. Эти сведения пропускаются, если символы отладки недоступны.
LineNumber	Номер строки в FileName, где содержится исходный код MethodName для инструкции в стеке вызова. Эти сведения пропускаются, если символы отладки недоступны.

Свойство My.Applicaiton.Info.StackTrace обеспечивает функциональность, аналогичную свойству StackTrace.

Пример

В этом примере свойство My.Application.Info.StackTrace используется для отображения трассировки стека приложения, начиная с того места, в котором выполняется код.

MsgBox("Stack trace: " & My.Application.Info.StackTrace)

Требования

Пространство имен:Microsoft.VisualBasic.ApplicationServices

Класс:AssemblyInfo

Сборка: библиотека времени выполнения Visual Basic (в Microsoft.VisualBasic.dll)

Доступность по типу проекта

Тип проекта	Доступность
Приложение Windows	Да
Библиотека классов	Да
Консольное приложение	Да
Библиотека элементов управления Windows	Да
Библиотека веб-элементов управления	Нет
Служба Windows	Да
Веб-узел	Нет

Разрешения

Могут потребоваться следующие разрешения.

Разрешение	Описание
FileIOPermission	Управляет возможностью доступа к сведениям в пути к файлам. Связанное перечисление: PathDiscovery.