DkmSuccessEvaluationResult Класс

Определение

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

public ref class DkmSuccessEvaluationResult : Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResult
[System.Runtime.InteropServices.Guid("5d948996-5805-1795-8b6b-535f0bc32bde")]
public class DkmSuccessEvaluationResult : Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResult
[<System.Runtime.InteropServices.Guid("5d948996-5805-1795-8b6b-535f0bc32bde")>]
type DkmSuccessEvaluationResult = class
    inherit DkmEvaluationResult
Public Class DkmSuccessEvaluationResult
Inherits DkmEvaluationResult
Наследование
Атрибуты

Свойства

Access

Уровень контроля доступа (открытый, частный и т. д.) результата оценки.

Address

Используемых Если результатом является адрес (т. е. флаг адреса установлен в параметре flags), задает расположение резервного значения. Используется, когда результат вычисления используется в качестве входных данных для окна памяти или окна дизассемблирования. Если это адрес инструкции, он должен иметь набор адресов Кпуинструктион.

Category

Категория (например, данные, метод и т. д.) результата оценки.

CustomUIVisualizers

Используемых Список пользовательских средств просмотра для этого объекта.

EditableValue

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

ExternalModules

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

Flags

Флаги, которые указывают на атрибуты результата вычисления выражения.

FullName

Используемых Полное имя выражения, к которому применяется этот результат. Это значение позволяет добавлять дочерние элементы в окно Контрольные значения (Добавить контрольное значение из контекстного меню) и обновлять части дерева вычисления. В качестве примера того, как FullName отличается от Name, имя 0-го элемента массива в C++ равно "[0]", а полное имя — "Мяррайвариабле [0]". В Visual Studio 14 и более поздних версиях при необходимости можно вычислить полное имя. Для этого средство оценки выражений должно создать Дкмевалуатионресулт с полным именем, равным null, и реализовать Идкмфуллнамепровидер. Затем Конкорд вызывает Идкмфуллнамепровидер. Калкулатефуллнаме, чтобы получить полное имя при необходимости в пользовательском интерфейсе.

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

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

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

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

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

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

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

Язык, используемый для выполнения проверок.

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

Имя выражения, к которому применяется этот результат.

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

Используемых Если задано Дкмевалуатионресултфлагс:: Каневалуатенов, задает текст, отображаемый в виде подсказки, когда пользователь наводит указатель мыши на кнопку Refresh (обновить). Если это значение равно null, будет использоваться сообщение по умолчанию.

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

RuntimeInstance

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

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

Кадр стека, в котором был создан результат этого выражения.

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

Тип хранилища (например, статический) результата вычисления.

TagValue

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

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

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

TypeModifierFlags

Флаги модификатора типа (ex: const) результата вычисления.

UniqueId

Идентификатор GUID, который однозначно определяет этот результат оценки.

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

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

Методы

AddToFavorites(DkmSuccessEvaluationResult)

Добавляет указанный дочерний элемент в коллекцию элементов избранного в типе этого результата.

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

Этот API появился в Visual Studio 16 с обновлением 4 (Дкмапиверсион. VS16Update4).

Close()

Закрывает объект результата вычисления для освобождения связанных с ним ресурсов. Этот метод должен вызываться компонентом, который инициировал перечисление (например, с именем Дкминспектионконтекст. Евалуатикспрессион, Дкмевалуатионресултенумконтекст. Items и т. д.).

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

(Унаследовано от DkmEvaluationResult)
Create(DkmInspectionContext, DkmStackWalkFrame, String, String, DkmEvaluationResultFlags, String, String, String, DkmEvaluationResultCategory, DkmEvaluationResultAccessType, DkmEvaluationResultStorageType, DkmEvaluationResultTypeModifierFlags, DkmDataAddress, ReadOnlyCollection<DkmCustomUIVisualizerInfo>, ReadOnlyCollection<DkmModuleInstance>, DkmDataItem)

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

Create(DkmInspectionContext, DkmStackWalkFrame, String, String, DkmEvaluationResultFlags, String, String, String, DkmEvaluationResultCategory, DkmEvaluationResultAccessType, DkmEvaluationResultStorageType, DkmEvaluationResultTypeModifierFlags, DkmDataAddress, ReadOnlyCollection<DkmCustomUIVisualizerInfo>, ReadOnlyCollection<DkmModuleInstance>, String, DkmDataItem)

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

         Этот API появился в Visual Studio 15 RTM (Дкмапиверсион. VS15RTM).
CreateDebuggeeSideVisualizerObject(UInt32, String, String, String)

Создает экземпляр пользовательского визуализатора на стороне отлаживаемого кода в отлаживаемом процессе.

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

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

CreateObjectId()

Создает идентификатор объекта для этого конкретного выражения.

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

(Унаследовано от DkmEvaluationResult)
CreateReplacementObjectOnDebuggeeSideVisualizer(Byte[], String, String, String)

Выполняет метод функция createreplacementobject (...) настраиваемого типа визуализатора на стороне отлаживаемого кода и записывает результат в визуальный объектный маркер.

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

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

DestroyDebuggeeSideVisualizerObject()

Освобождает тип пользовательского визуализатора на стороне отлаживаемого кода в отлаживаемом процессе.

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

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

DestroyObjectId()

Уничтожает идентификатор объекта для данного конкретного выражения.

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

(Унаследовано от DkmEvaluationResult)
ExtractFromProperty(IDebugProperty3)

Получает объект Дкмсукцессевалуатионресулт, который создает резервную копию объекта IDebugProperty3. Этот API будет работать правильно только из основного потока Visual Studio.

GetChildren(DkmWorkList, Int32, DkmInspectionContext, DkmCompletionRoutine<DkmGetChildrenAsyncResult>)

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

Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента выполняется асинхронно. Вызывающий объект будет уведомлен о завершении выполнения запроса через подпрограмму завершения.

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

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

Возвращает базовый Дкмклрвалуе из Дкмсукцессевалуатионресулт, если он существует.

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

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

GetDataBreakpointDisplayName()

Возвращает отображаемое имя точки останова по данным для результата вычисления.

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

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

GetDataBreakpointDisplayName(DkmWorkList, DkmCompletionRoutine<DkmGetDataBreakpointDisplayNameAsyncResult>)

Возвращает отображаемое имя точки останова по данным для результата вычисления.

Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента выполняется асинхронно. Вызывающий объект будет уведомлен о завершении выполнения запроса через подпрограмму завершения.

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

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

GetDataBreakpointInfo(DkmWorkList, DkmCompletionRoutine<DkmGetDataBreakpointInfoAsyncResult>)

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

Этот метод добавляет новый рабочий элемент в указанный список работ и возвращается после добавления рабочего элемента. Фактическая обработка рабочего элемента выполняется асинхронно. Вызывающий объект будет уведомлен о завершении выполнения запроса через подпрограмму завершения.

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

Этот API появился в Visual Studio 15 с обновлением 8 (Дкмапиверсион. VS15Update8).

GetDataBreakpointInfo(String)

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

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

Этот API появился в Visual Studio 15 с обновлением 8 (Дкмапиверсион. VS15Update8).

GetDataFromDebuggeeSideVisualizer(String, String, String)

Выполняет метод GetData (...) типа пользовательского визуализатора на стороне отлаживаемого кода.

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

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

GetDataItem<T>()

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

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

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

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

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

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

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

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

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

Этот API появился в Visual Studio 16 с обновлением 4 (Дкмапиверсион. VS16Update4).

ResolveAssembly(String, String, ReadOnlyCollection<Byte>)

Разрешает имя сборки в путь к сборке или на необработанные байты.

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

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

SetDataItem<T>(DkmDataCreationDisposition, T)

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

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

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

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

(Унаследовано от DkmEvaluationResult)
TransferDataToDebuggeeSideVisualizer(Byte[], String, String, String)

Выполняет метод Трансфердата (...) типа пользовательского визуализатора на стороне отлаживаемого кода.

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

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

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

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

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