DkmRootVisualizedExpression Класс

Определение

Объект Dispatcher, представляющий визуальное выражение верхнего уровня. Экземпляр создается средством оценки выражений при определении типа для визуализации.

public ref class DkmRootVisualizedExpression : Microsoft::VisualStudio::Debugger::Evaluation::DkmVisualizedExpression
[System.Runtime.InteropServices.Guid("78ad085c-7b73-5937-a063-e2c7f4ee6556")]
public class DkmRootVisualizedExpression : Microsoft.VisualStudio.Debugger.Evaluation.DkmVisualizedExpression
[<System.Runtime.InteropServices.Guid("78ad085c-7b73-5937-a063-e2c7f4ee6556")>]
type DkmRootVisualizedExpression = class
    inherit DkmVisualizedExpression
Public Class DkmRootVisualizedExpression
Inherits DkmVisualizedExpression
Наследование
Атрибуты

Свойства

ArrayLength

Устарело: больше не используется.

Flags

Флаги средство оценки выражений передает в надстройку визуализатора, описывающую рассматриваемое значение. Например, это будет включать, если объект является указателем, или если он является ссылкой.

FullName

Полное имя выражения вплоть до корневого узла. Надстройки могут использовать это полное имя или создавать собственные. Однако если надстройка использует другое полное имя, она должна быть проанализирована средством оценки выражений.

InspectionContext

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

(Унаследовано от DkmVisualizedExpression)
InspectionSession

Инспектионсессион позволяет различным компонентам, которые анализируют данные в целевом процессе, хранить закрытые данные с тем же временем существования. Сеансы проверки закрываются, когда пользователь пытается продолжить процесс.

(Унаследовано от DkmVisualizedExpression)
IsUnloaded

Возвращает значение true, если для данного объекта было вызвано событие "выгружено" (например, вызывается метод Дкмсреад:: Unload), или значение, если объект был закрыт. Обратите внимание, что необходимо использовать осторожность при проверке этого состояния как, без синхронизации, возвращаемое состояние может больше не быть точным после считывания инструкции.

(Унаследовано от DkmDataContainer)
Module

Используемых Модуль, содержащий символ типа.

Name

Имя выражения вплоть до корневого узла. Надстройки могут использовать это имя или создавать собственные.

RuntimeInstance

Указывает, какой монитор среды выполнения будет использоваться для выполнения этой оценки.

(Унаследовано от DkmVisualizedExpression)
SourceId

GUID, связывающий средство оценки выражений, которое создало этот объект и сам объект. Обычно используется вычислителями выражений для фильтрации своей реализации Идкмкустомвисуализеркаллбакк только для Дкмвисуализедекспрессион их создания.

(Унаследовано от DkmVisualizedExpression)
StackFrame

Кадр стека выражение вычисляется в выражении в.

(Унаследовано от DkmVisualizedExpression)
TagValue

Дкмвисуализедекспрессион является абстрактным базовым классом. Это перечисление указывает, какой производный класс этот объект является экземпляром.

(Унаследовано от DkmVisualizedExpression)
Type

Используемых Тип проверяемого объекта. Часто это тот же тип, на который ссылается запись natvis, вызвавшая надстройку. Однако он также может быть указателем или ссылкой на тип или даже базовым или производным классом типа. Надстройка не должна ничего предполагать о том, что находится в этой строке, и не должна пытаться проанализировать ее для получения сведений об объекте. Большинство надстроек должны передавать эту строку вместе со свойством "Type" создаваемого результата вычисления. Однако надстройка может добавить дополнительные заметки в строку Type, прежде чем возвратить ее обратно. За исключением указания того, что следует разместить в поле "тип" результата, эта строка не имеет значения для визуализации объекта. Независимо от того, является ли исходный объект указателем, ссылкой, базовым типом или производным типом, предоставляемый Дкмекспрессионвалуехоме всегда будет идентифицировать расположение самого объекта, а не указатель или ссылку на объект. Пустая строка типа может передаваться здесь, если тип результата вычисления не имеет значения для сценария, в котором вызывается визуализатор.

Этот API появился в Visual Studio 14 RTM (Дкмапиверсион. VS14RTM).

UniqueId

Идентификатор GUID, однозначно определяющий данный экземпляр.

(Унаследовано от DkmVisualizedExpression)
ValueHome

Используемых Расположение, в котором хранится значение, которое можно изменить для изменения значения. Это значение должно быть равно null для значений только для чтения, таких как целочисленные константы.

(Унаследовано от DkmVisualizedExpression)
VisualizerId

GUID, связывающий надстройку и выражения, вызывающие эту надстройку. Надстройка должна использовать идентификатор GUID, указанный в файле исходного визуализатора в качестве фильтра.

(Унаследовано от DkmVisualizedExpression)

Методы

Close()

Закрывает экземпляр объекта Дкмвисуализедекспрессион. При этом будут освобождены все ресурсы, связанные с этим объектом, для всех компонентов. Сюда входят ресурсы на компьютере или в пределах управляемого и машинного маршалинга.

Объекты Дкмвисуализедекспрессион автоматически закрываются при закрытии связанных с ними объектов Дкминспектионсессион.

(Унаследовано от DkmVisualizedExpression)
Create(DkmInspectionContext, Guid, Guid, DkmStackWalkFrame, DkmExpressionValueHome, DkmModule, String, String, DkmRootVisualizedExpressionFlags, UInt32, DkmDataItem)

Создайте новый экземпляр объекта Дкмрутвисуализедекспрессион.

Create(DkmInspectionContext, Guid, Guid, DkmStackWalkFrame, DkmExpressionValueHome, DkmModule, String, String, DkmRootVisualizedExpressionFlags, UInt32, String, DkmDataItem)

Создайте новый экземпляр объекта Дкмрутвисуализедекспрессион.

         Этот API появился в Visual Studio 14 RTM (Дкмапиверсион. VS14RTM).
CreateDefaultChildFullName(Int32)

Этот метод будет создавать полное имя по умолчанию для пользовательского визуального дочернего выражения. Это имя будет полным именем базового выражения и строкой формата развертывания, которое приведет к обратному вызову визуализатора выражений для получения дочерних элементов. Экземпляр Дкмвисуализедекспрессион, на который вызывается, должен быть родительским визуальным выражением для дочернего элемента и корневого визуального выражения для корня.

(Унаследовано от DkmVisualizedExpression)
EvaluateExpressionCallback(DkmInspectionContext, DkmLanguageExpression, DkmStackWalkFrame, DkmEvaluationResult)

Этот метод позволяет надстройке визуализатора использовать средство оценки выражений для компиляции и оценки значения по умолчанию для выражения. Надстройка может использовать этот результат как есть или переопределить поля путем создания нового результата. Кроме того, надстройка может использовать средство оценки выражений для расширения с помощью обратных вызовов Get Children.

(Унаследовано от DkmVisualizedExpression)
EvaluateVisualizedExpression(DkmEvaluationResult)

Вычисление наглядного выражения, возвращающего для него Дкмевалуатионресулт.

Ограничение расположения: API должен вызываться из компонента IDE (уровень компонентов > 100 000).

(Унаследовано от DkmVisualizedExpression)
GetChildren(Int32, DkmInspectionContext, DkmChildVisualizedExpression[], DkmEvaluationResultEnumContext)

Возвращает контекст перечисления, используемый для получения дочерних элементов данного результата оценки. Он используется во всех окнах вычисления выражений.

Ограничение расположения: API должен вызываться из компонента IDE (уровень компонентов > 100 000).

(Унаследовано от DkmVisualizedExpression)
GetChildrenCallback(DkmEvaluationResult, Int32, DkmInspectionContext, DkmEvaluationResult[], DkmEvaluationResultEnumContext)

Этот метод позволяет надстройке визуализатора использовать средство оценки выражений для расширения. Результат вычисления, содержащийся в визуальном выражении, должен быть получен от средства оценки выражений через Евалуатикспрессионкаллбакк.

(Унаследовано от DkmVisualizedExpression)
GetDataItem<T>()

Возвращает экземпляр элемента "t", который был добавлен в этот экземпляр контейнера. Если этот контейнер не содержит 'T, эта функция возвратит значение null.

(Унаследовано от DkmDataContainer)
GetItems(DkmEvaluationResultEnumContext, Int32, Int32, DkmChildVisualizedExpression[])

Вызывается для получения элементов из экземпляра Дкмевалуатионресултенумконтекст, созданных при предыдущем вызове метода Children.

Ограничение расположения: API должен вызываться из компонента IDE (уровень компонентов > 100 000).

(Унаследовано от DkmVisualizedExpression)
GetItemsCallback(DkmEvaluationResultEnumContext, Int32, Int32, DkmEvaluationResult[])

Этот метод позволяет надстройке визуализатора использовать средство оценки выражений для расширения с помощью переданного контекста перечисления. Используется для получения локальных переменных кадра стека или дочерних элементов из результата оценки.

(Унаследовано от DkmVisualizedExpression)
GetSymbolInterface(Guid, Object)

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

Ограничение расположения: API должен вызываться из компонента IDE (уровень компонентов > 100 000).

(Унаследовано от DkmVisualizedExpression)
GetUnderlyingString()

Этот метод используется для результатов оценки, включающих Дкмевалуатионресултфлагс. Равстринг для получения базовой строки без заключения кавычек или escape-последовательностей. Этот метод вызывается для отображения одного из различных визуализаторов строки в окне вычисления выражения (щелкните значок лупы).

Ограничение расположения: API должен вызываться из компонента IDE (уровень компонентов > 100 000).

(Унаследовано от DkmVisualizedExpression)
GetUnderlyingStringCallback(DkmEvaluationResult)

Этот метод используется для результатов оценки, включающих Дкмевалуатионресултфлагс. Равстринг для получения базовой строки без заключения кавычек или escape-последовательностей. Этот метод вызывается для отображения одного из различных визуализаторов строки в окне вычисления выражения (щелкните значок лупы).

(Унаследовано от DkmVisualizedExpression)
RemoveDataItem<T>()

Удалить экземпляр из этого контейнера. Обычно нет необходимости вызывать этот метод, так как контейнер данных будет автоматически очищаться при закрытии объекта.

(Унаследовано от DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)

Поместите новый элемент в контейнер данных.

(Унаследовано от DkmDataContainer)
SetValueAsString(String, Int32, String)

Изменяет значение заданного результата вычисления (предполагается, что оно не доступно только для чтения) в соответствии с заданной строкой. Он используется после того, как пользователь редактирует значение в любом из окон оценки.

Ограничение расположения: API должен вызываться из компонента IDE (уровень компонентов > 100 000).

(Унаследовано от DkmVisualizedExpression)
SetValueAsStringCallback(DkmEvaluationResult, String, Int32, String)

Изменяет значение заданного результата вычисления (предполагается, что оно не доступно только для чтения) в соответствии с заданной строкой. Он используется после того, как пользователь редактирует значение в любом из окон оценки.

(Унаследовано от DkmVisualizedExpression)
UseDefaultEvaluationBehavior(Boolean, DkmEvaluationResult)

Вызывается средством оценки выражений при расширении дочерних элементов визуального выражения, задании значения или получении базовой строки. Если надстройке визуализатора требуется полный контроль над выражением, оно должно возвращать значение false. Затем он будет принимать вызовы к функциям Сетвалуеасстринг и Жетундерлингстринг. Если надстройка визуализатора хочет полностью отложить эти операции на средство оценки выражений, оно должно возвращать значение true. Он также должен предоставить средству оценки выражений экземпляр Дкмевалуатионресулт, поступилный от EE, через один из методов Идкмкустомвисуализеркаллбакк. Обратите внимание, что надстройка должна получить Дкмевалуатионресулт по умолчанию из EE, если она хочет управлять объектом EE. Возврат значения true из этого метода в основном используется надстройками визуализатора, которые просто изменяют что-то небольшое, как представление значения, но не хотят изменять расширение или значения параметров.

Ограничение расположения: API должен вызываться из компонента IDE (уровень компонентов > 100 000).

(Унаследовано от DkmVisualizedExpression)

Явные реализации интерфейса

IDisposable.Dispose() (Унаследовано от DkmVisualizedExpression)

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