DkmInspectionContext Класс

Определение

Пространство имен:

Microsoft.VisualStudio.Debugger.Evaluation

Сборка:

Microsoft.VisualStudio.Debugger.Engine.dll

Пакет:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Параметры и целевой контекст для использования при выполнении операции проверки.

public ref class DkmInspectionContext

[Windows::Foundation::Metadata::WebHostHidden]
public ref class DkmInspectionContext

[Windows::Foundation::Metadata::WebHostHidden]
class DkmInspectionContext

[System.Runtime.InteropServices.Guid("0807c826-3338-dd99-2f3a-202ba8fb9da7")]
public class DkmInspectionContext

[<System.Runtime.InteropServices.Guid("0807c826-3338-dd99-2f3a-202ba8fb9da7")>]
type DkmInspectionContext = class

Public Class DkmInspectionContext

Наследование

Object

DkmInspectionContext

Атрибуты

GuidAttribute

Свойства

AdditionalVisualizationData	[Необязательно] Указывает необязательный список полных путей к файлам визуализации для использования в дополнение к файлам по умолчанию из каталога профилей пользователей и каталога установки Visual Studio. Приоритет между конфликтующими визуализаторами в этих путях по отношению к стандартным путям разрешается в соответствии со сведениями, указанными в разделе AdditionalVisualizationDataPriority. Этот API появился в Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
AdditionalVisualizationDataPriority	Если указан параметр AdditionalVisualizationData, указывает приоритет таких данных относительно расположений поиска по умолчанию. Этот API появился в Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
EvaluationFlags	Флаги, влияющие на анализ, компиляцию или отображение входного выражения.
FuncEvalFlags	Флаги, влияющие на выполнение запросов на оценку функций.
InspectionSession	InspectionSession позволяет различным компонентам, которые проверяют данные в целевом процессе, хранить личные данные с одинаковым временем существования. Сеансы проверки закрываются, когда пользователь пытается продолжить процесс.
Language	Язык, используемый для выполнения проверок.
Radix	Радикс, используемый при форматировании целочисленных данных. В настоящее время поддерживаются значения "16" и "10".
ReturnValue	[Необязательно] Не рекомендуется — не используйте. Вместо этого компоненты должны использовать свойство ReturnValues в качестве списка всех возвращаемых значений и задать $ReturnValue для представления последнего элемента возвращаемого значения в списке.
ReturnValues	[Необязательно] Необработанное представление значений для $ReturnValue 1, $ReturnValue 2 и т. д. Этот API появился в Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
RuntimeInstance	Указывает, какой монитор среды выполнения будет использоваться для выполнения этой оценки.
SymbolsConnection	[Необязательно] Если значение не равно NULL, это указывает подключение к рабочему процессу, в котором обрабатываются символы для этой операции проверки. Это значение будет иметь значение NULL, если символы загружаются в процессе интегрированной среды разработки или если они загружены в удаленный отладчик (DkmModule.Connection имеет значение, отличное от NULL). Этот API появился в Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview).
Thread	Проверяемый поток.
Timeout	Это время ожидания, которое будет использоваться для потенциально медленных операций, таких как оценка функции. Это значение задается в миллисекундах.

Методы

ClrExpressionMayRequireParentheses(String)	Возвращает значение true, если для выражения могут потребоваться круглые скобки при использовании в качестве вложенного выражения в языке. Ограничение расположения. API должен вызываться из компонента Monitor (уровень < компонента 100 000). Этот API появился в Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue)	Create новый экземпляр объекта DkmInspectionContext.
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority)	Create новый экземпляр объекта DkmInspectionContext. Этот API появился в Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority, ReadOnlyCollection<DkmRawReturnValueContainer>)	Create новый экземпляр объекта DkmInspectionContext. Этот API появился в Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority, ReadOnlyCollection<DkmRawReturnValueContainer>, DkmWorkerProcessConnection)	Create новый экземпляр объекта DkmInspectionContext. Этот API появился в Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview).
EvaluateExpression(DkmWorkList, DkmLanguageExpression, DkmStackWalkFrame, DkmCompletionRoutine<DkmEvaluateExpressionAsyncResult>)	Привяжите входное выражение и оцените его. Затем отформатируйте полученное значение для отображения в отладчике. Используется для подсказок по данным, окон watch, непосредственного окна и т. д. Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента является асинхронной. Вызывающий объект получит уведомление о том, что запрос завершен с помощью процедуры завершения. Ограничение расположения. Компоненты интегрированной среды разработки могут вызывать этот метод независимо от типа отлаживаемого кода. Этот метод также в настоящее время поддерживается для компонентов монитора отладки при отладке кода, выполняемого в среде CLR; однако эта функция может быть удалена в будущей версии.
EvaluateExpressionOnThreads(DkmWorkList, ReadOnlyCollection<UInt64>, DkmStackWalkFrame, DkmLanguageExpression, DkmCompletionRoutine<DkmEvaluateExpressionOnThreadsAsyncResult>)	Привяжите входное выражение и оцените его. Затем отформатируйте полученное значение для отображения в отладчике. Используется для подсказок по данным, окон watch, непосредственного окна и т. д. Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента является асинхронной. Вызывающий объект получит уведомление о том, что запрос завершен с помощью процедуры завершения. Ограничение расположения: API должен вызываться из компонента интегрированной среды разработки (уровень > компонента 100 000).
EvaluateReturnValue(DkmWorkList, DkmStackWalkFrame, DkmRawReturnValue, DkmCompletionRoutine<DkmEvaluateReturnValueAsyncResult>)	Оценивает и форматирует заданное значение DkmRawReturnValue, используя только предоставленные данные. Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента является асинхронной. Вызывающий объект получит уведомление о том, что запрос завершен с помощью процедуры завершения. Ограничение расположения: API должен вызываться из компонента интегрированной среды разработки (уровень > компонента 100 000).
EvaluateReturnValue2(DkmWorkList, DkmStackWalkFrame, DkmRawReturnValueContainer, DkmCompletionRoutine<DkmEvaluateReturnValueAsyncResult2>)	Оценивает и форматирует заданное значение DkmRawReturnValue, используя только предоставленные данные. Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента является асинхронной. Вызывающий объект получит уведомление о том, что запрос завершен с помощью процедуры завершения. Ограничение расположения: API должен вызываться из компонента интегрированной среды разработки (уровень > компонента 100 000). Этот API появился в Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
GetClrArrayIndexExpression(String[])	Получение выражения индекса массива. Ограничение расположения. API должен вызываться из компонента Monitor (уровень < компонента 100 000). Этот API появился в Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrCastExpression(String, DkmClrType, DkmClrCustomTypeInfo, DkmClrCastExpressionOptions)	Возвращает выражение приведения, если допустимый синтаксис. Ограничение расположения. API должен вызываться из компонента Monitor (уровень < компонента 100 000). Этот API появился в Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrExpressionAndFormatSpecifiers(String, ReadOnlyCollection<String>)	Разделяет строку на части описатель выражения и формата. Ограничение расположения. API должен вызываться из компонента Monitor (уровень < компонента 100 000). Этот API появился в Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrExpressionForNull()	Получение выражения для конкретного языка для null (ключевое слово). Ограничение расположения. API должен вызываться из компонента Monitor (уровень < компонента 100 000). Этот API появился в Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrExpressionForThis()	Получение выражения для конкретного языка для этого или Me. Ограничение расположения. API должен вызываться из компонента Monitor (уровень < компонента 100 000). Этот API появился в Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrLocalVariableQuery(DkmClrInstructionAddress, Boolean)	Получите DkmCompiledClrLocalsQuery, чтобы разрешить просмотр локальных переменных. Ограничение расположения: API должен вызываться из компонента интегрированной среды разработки (уровень > компонента 100 000). Этот API появился в Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
GetClrMemberName(String, DkmClrType, DkmClrCustomTypeInfo, String, Boolean, Boolean)	Получите выражение доступа к члену, если оно может быть представлено как допустимый синтаксис. Ограничение расположения. API должен вызываться из компонента Monitor (уровень < компонента 100 000). Этот API появился в Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrNameForField(DkmClrModuleInstance, Int32)	Получите имя идентификатора для конкретного языка из метаданных. Ограничение расположения. API должен вызываться из компонента Monitor (уровень < компонента 100 000). Этот API появился в Visual Studio 16 с обновлением 10 (DkmApiVersion.VS16Update10).
GetClrNameForLocalVariable(DkmClrModuleInstance, DkmClrMethodId, DkmILRange, DkmClrLocalVariable)	Получите имя идентификатора для конкретного языка из метаданных. Ограничение расположения. API должен вызываться из компонента Monitor (уровень < компонента 100 000). Этот API появился в Visual Studio 16 с обновлением 10 (DkmApiVersion.VS16Update10).
GetClrObjectCreationExpression(DkmClrType, DkmClrCustomTypeInfo, String[])	Возвращает выражение создания объекта, если допустимый синтаксис. Ограничение расположения. API должен вызываться из компонента Monitor (уровень < компонента 100 000). Этот API появился в Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrTypeName(DkmClrType, DkmClrCustomTypeInfo)	Получите имя типа в форме, допустимой на языке, если допустимый синтаксис. Этот метод предназначен для создания допустимых полных имен с возможностью экранирования или возврата значений NULL, если нет допустимого синтаксиса. Ограничение расположения. API должен вызываться из компонента Monitor (уровень < компонента 100 000). Этот API появился в Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrValidIdentifier(String)	Получите идентификатор в форме, допустимой на языке. Ограничение расположения. API должен вызываться из компонента Monitor (уровень < компонента 100 000). Этот API появился в Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetFrameArguments(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameArgumentsAsyncResult>)	Предоставляет сведения о аргументах кадра стека. В настоящее время это доступно только через модель автоматизации VS (EnvDTE.StackFrame.Arguments). Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента является асинхронной. Вызывающий объект получит уведомление о том, что запрос завершен с помощью процедуры завершения. Ограничение расположения. Компоненты интегрированной среды разработки могут вызывать этот метод независимо от типа отлаживаемого кода. Этот метод также в настоящее время поддерживается для компонентов монитора отладки при отладке кода, выполняемого в среде CLR; однако эта функция может быть удалена в будущей версии.
GetFrameLocals(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameLocalsAsyncResult>)	Возвращает контекст перечисления, используемый для получения локальных переменных этого кадра стека. Используется при вычислении окна локальных переменных. Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента является асинхронной. Вызывающий объект получит уведомление о том, что запрос завершен с помощью процедуры завершения. Ограничение расположения. Компоненты интегрированной среды разработки могут вызывать этот метод независимо от типа отлаживаемого кода. Этот метод также в настоящее время поддерживается для компонентов монитора отладки при отладке кода, выполняемого в среде CLR; однако эта функция может быть удалена в будущей версии.
GetFrameName(DkmWorkList, DkmStackWalkFrame, DkmVariableInfoFlags, DkmCompletionRoutine<DkmGetFrameNameAsyncResult>)	Предоставляет текстовое представление кадра стека. Используется при построении форматированного стека вызовов. Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента является асинхронной. Вызывающий объект получит уведомление о том, что запрос завершен с помощью процедуры завершения. Ограничение расположения. Компоненты интегрированной среды разработки могут вызывать этот метод независимо от типа отлаживаемого кода. Этот метод также в настоящее время поддерживается для компонентов монитора отладки при отладке кода, выполняемого в среде CLR; однако эта функция может быть удалена в будущей версии.
GetFrameReturnType(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameReturnTypeAsyncResult>)	Предоставляет текстовое представление типа возвращаемого значения для одного или нескольких кадров стека. В настоящее время это доступно только через модель автоматизации VS (EnvDTE.StackFrame.ReturnType). Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента является асинхронной. Вызывающий объект получит уведомление о том, что запрос завершен с помощью процедуры завершения. Ограничение расположения: API должен вызываться из компонента интегрированной среды разработки (уровень > компонента 100 000).
GetTypeName(DkmClrType, DkmClrCustomTypeInfo, ReadOnlyCollection<String>)	Возвращает строку имени типа, отображаемую в пользовательском интерфейсе для заданного типа DkmClrType. Этот метод всегда возвращает значение и используется в окнах проверки переменных. Ограничение расположения. API должен вызываться из компонента Monitor (уровень < компонента 100 000). Этот API появился в Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
WithProperties(UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32)	Создает копию исходного DkmInspectionContext с обновленными предоставленными свойствами, такими как EvaluationFlags или Radix. Свойства являются полной заменой исходных свойств и не будут объединены с исходными свойствами. Поэтому все требуемые свойства из исходного DkmInspectionContext должны быть предоставлены этому методу. Этот API появился в Visual Studio 17 с обновлением 8 (DkmApiVersion.VS17Update8).