Debugger4 - интерфейс
Объект Debugger4 используется для получения и изменения состояния отладчика и отлаживаемой программы. Интерфейс Debugger4 имеет приоритет над интерфейсами Debugger3.
Пространство имен: EnvDTE90a
Сборка: EnvDTE90a (в EnvDTE90a.dll)
Синтаксис
'Декларация
<GuidAttribute("133BAD54-8E8D-451B-9DB0-AF38ED9819CC")> _
Public Interface Debugger4 _
Inherits Debugger3
[GuidAttribute("133BAD54-8E8D-451B-9DB0-AF38ED9819CC")]
public interface Debugger4 : Debugger3
[GuidAttribute(L"133BAD54-8E8D-451B-9DB0-AF38ED9819CC")]
public interface class Debugger4 : Debugger3
[<GuidAttribute("133BAD54-8E8D-451B-9DB0-AF38ED9819CC")>]
type Debugger4 =
interface
interface Debugger3
end
public interface Debugger4 extends Debugger3
Тип Debugger4 предоставляет следующие члены.
Свойства
| Имя | Описание | |
|---|---|---|
.gif "Открытое свойство") |
AllBreakpointsLastHit | Возвращает коллекцию связанных точек останова, в которые произошло последнее одновременное попадание. |
|
BreakpointLastHit | Возвращает последнюю точку останова, в которую произошло попадание.Сведения о получении нескольких точек останова, достигнутых одновременно, см. в описании свойства AllBreakpointsLastHit. |
|
Breakpoints | Возвращает коллекцию точек останова. |
|
CurrentMode | Возвращает текущий режим отладчика в контексте интегрированной среды разработки. |
|
CurrentProcess | Возвращает или задает активный процесс. |
|
CurrentProgram | Возвращает или задает активную программу. |
|
CurrentStackFrame | Возвращает или задает текущий кадр стека. |
|
CurrentThread | Возвращает или задает отлаживаемый текущий поток. |
|
DebuggedProcesses | Получает список отлаживаемых в текущий момент процессов. |
|
DTE | Возвращает объект расширения верхнего уровня. |
|
ExceptionGroups | Возвращает параметры исключений для отладчика.Для каждого исключения эти параметры определяют, должен ли отладчик перед остановом выполнения предоставлять коду возможность обработки исключения. |
|
ForceContinue | Возвращает или задает значение, которое определяет, следует ли отладчику прерывать или продолжать работу, если выполнение макроса останавливается в точке останова или трассировки.Поведение по умолчанию задается пользователем в диалоговом окне при создании точки трассировки или останова.Данное свойство можно использовать для изменения поведения по умолчанию. |
|
HexDisplayMode | Возвращает или задает значение, указывающее, в каком формате выводятся выражения: шестнадцатеричном или десятичном. |
|
HexInputMode | Возвращает или задает значение, указывающее, в каком формате вычисляются выражения: шестнадцатеричном или десятичном. |
|
Languages | Возвращает список языков, которые поддерживает отладчик. |
|
LastBreakReason | Возвращает последнюю причину прерывания работы программы.Если программа работает, возвращается значение DBG_REASON_NONE. |
|
LocalProcesses | Получает список процессов, выполняющихся в данный момент на этом компьютере. |
|
OnlyLoadSymbolsManually | Возвращает значение, которое определяет, как загружаются символы: автоматически или вручную.Этот параметр определяется пользователем Visual Studio в диалоговом окне Параметры.Дополнительные сведения об установке этого значения в Visual Studio см. в разделе [УСТАРЕЛО] Практическое руководство. Указание мест расположения символов и поведения загрузки. |
|
Parent | Возвращает непосредственный родительский объект для объекта Debugger4 (DTE2). |
|
SymbolCachePath | Возвращает строку, содержащую путь к кэшу символов, который используется в среде Visual Studio при загрузке символов с сервера символов.Путь к кэшу символов можно указать в диалоговом окне Параметры.Для получения дополнительной информации см. [УСТАРЕЛО] Практическое руководство. Использование сервера символов. |
|
SymbolPath | Возвращает строку, содержащую путь к PDB-файлам символов, которые используются в среде Visual Studio для отладки.Пути к объектам символов определяется пользователем Visual Studio в диалоговом окне Параметры.Дополнительные сведения см. в разделе [УСТАРЕЛО] Практическое руководство. Указание мест расположения символов и поведения загрузки. |
|
SymbolPathState | Возвращает строку, представляющую состояние всех символьных путей для PDB-файлов символов, которые используются в среде Visual Studio для отладки. |
|
Transports | Возвращает коллекцию поддерживаемых транспортов отладки. |
В начало страницы
Методы
| Имя | Описание | |
|---|---|---|
.gif "Открытый метод") |
Break | Вызывает приостановку выполнения указанного процесса, чтобы можно было проанализировать его состояние. |
|
DetachAll | Отсоединяется от всех присоединенных программ. |
|
ExecuteStatement | Выполняет указанный оператор.Если флаг TreatAsExpression принимает значение true, строка интерпретируется как выражение и результат направляется в Окно "Команда". |
|
GetExpression | Вычисляет выражение, основанное на текущем кадре стека.Если выражение можно проанализировать, но нельзя вычислить, то объект все равно возвращается, но при этом значение его будет недействительно. |
|
GetExpression2 | Вычисляет выражение, основанное на текущем кадре стека.Если выражение можно проанализировать, но нельзя вычислить, то объект все равно возвращается, но при этом значение его будет недействительно.Этот метод аналогичен методу GetExpression, однако содержит дополнительный логический параметр, для которого можно задать значение "true", чтобы указать на необходимость вычисления данного выражения как оператора. |
|
GetExpression3 | Вычисляет выражение аналогично методу GetExpression.Однако данный метод позволяет вызывающему объекту указать кадр стека, в котором будет выполняться вычисление.Он также позволяет вызывающему объекту указать, следует ли автоматически вычислять свойства и выполнять неявные вызовы функции. |
|
GetProcesses | Возвращает объект, представляющий процессы, которые в настоящий момент подключены для отладки в указанном транспорте. |
|
Go | Запускает выполнение программы, начиная с текущего оператора. |
|
RunToCursor | Выполняет программу до строки, на которой в данный момент находится курсор. |
|
SetNextStatement | Указывает оператор, который будет выполнен следующим, в соответствии с позицией курсора в текущем исходном файле. |
|
SetSymbolSettings | Задает различные параметры PDB-файлов символов, используемых в Visual Studio для отладки, и указывает на необходимость принудительной повторной загрузки символов. |
|
StepInto | При возможности выполняет шаг с заходом в следующий вызов функции. |
|
StepOut | Выходит из текущей функции. |
|
StepOver | Обходит вызов следующей функции. |
|
Stop | Прекращает отладку и завершает или отсоединяет все вложенные процессы. |
|
TerminateAll | Завершает все отлаживаемые в данный момент процессы. |
|
WriteMinidump | При отладке программы и в режиме приостановки, эта функция создает малый дамп текущего сеанса отладки. |
В начало страницы
Заметки
Доступ к отладчику можно получить с помощью объекта DTE2 через его свойство Debugger. Для каждого экземпляра интегрированной среды разработки (IDE) существует один объект отладчика.
Чтобы использовать интерфейс Debugger4, необходимо добавить ссылку на библиотеку EnvDTE90a.dll. Для разработки машинного кода добавляйте ссылку на библиотеку dte90a.tlb.
Примеры
См. раздел Debugger3.