Udostępnij za pośrednictwem


DkmIntermediateEvaluationResult Class

Definition

The formatted result of an evaluation that must be re-evaluated by a different Expression Evaluator.

This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

public ref class DkmIntermediateEvaluationResult : Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResult
[System.Runtime.InteropServices.Guid("1fe38f12-16e3-0c9d-7bdb-91aabf324221")]
public class DkmIntermediateEvaluationResult : Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResult
[<System.Runtime.InteropServices.Guid("1fe38f12-16e3-0c9d-7bdb-91aabf324221")>]
type DkmIntermediateEvaluationResult = class
    inherit DkmEvaluationResult
Public Class DkmIntermediateEvaluationResult
Inherits DkmEvaluationResult
Inheritance
DkmIntermediateEvaluationResult
Inheritance
DkmIntermediateEvaluationResult
Attributes

Properties

Access

Access level of the evaluation result. This overrides the DkmEvaluationResultAccessType of the final evaluation result. Use DkmEvaluationResultAccessType::None to defer to that of the final evaluation result.

This API was introduced in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).

Category

Category of the evaluation result. This overrides the DkmEvaluationResultCategory of the final evaluation result. Use DkmEvaluationResultCategory::Other to defer to that of the final evaluation result.

This API was introduced in Visual Studio 14 Update 1 (DkmApiVersion.VS14Update1).

Expression

Expression that should be evaluated by a different Expression Evaluator than the one that generated the DkmIntermediateResult.

This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

FullName

[Optional] The full name of the expression this result applies to. This value is used to allow child elements to be added to the watch window (Add Watch from the context menu), and to refresh parts of the evaluation tree. As an example of how FullName differs from name, the name of the 0th element of an array in C++ is '[0]' while the full name would by 'myArrayVariable[0]'. For Visual Studio 14 and later it's possible to calculate the full name later if needed. To do this, the expression evaluator should create the DkmEvaluationResult with a null full name and implement IDkmFullNameProvider. Concord will then call IDkmFullNameProvider.CalculateFullName to get the full name when needed in the UI.

(Inherited from DkmEvaluationResult)
InspectionContext

Inspection context used to create this evaluation result.

(Inherited from DkmEvaluationResult)
InspectionSession

The InspectionSession allows the various components which examine data in the target process to store private data with the same lifetime. Inspection sessions are closed when the user attempts to continue the process.

(Inherited from DkmEvaluationResult)
IntermediateLanguage

The language of Expression. This is different from DkmEvaluationResult->Language(), which specifies the language of the initial evaluation. IntermediateLanguage specifies the language of the re-evaluation.

This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

IsUnloaded

Returns true if a 'unloaded' event has been raised for this object (example: DkmThread::Unload is called) or if the object has been closed. Note that care must be used when checking this status as, without synchronization, the returned status may no longer be accurate the instruction after it is read.

(Inherited from DkmDataContainer)
Language

Language used to perform inspections.

(Inherited from DkmEvaluationResult)
Name

The name of the expression this result applies to.

(Inherited from DkmEvaluationResult)
RuntimeInstance

Indicates which runtime monitor will be used to perform this evaluation.

(Inherited from DkmEvaluationResult)
StackFrame

The stack frame this expression result was created on.

(Inherited from DkmEvaluationResult)
Storage

storage type of the evaluation result. This overrides the DkmEvaluationResultStorageType of the final evaluation result. Use DkmEvaluationResultStorageType::None to defer to that of the final evaluation result.

This API was introduced in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).

TagValue

DkmEvaluationResult is an abstract base class. This enum indicates which derived class this object is an instance of.

(Inherited from DkmEvaluationResult)
TargetRuntime

The runtime of the Expression Evaluator that would consume the intermediate result and produce a final result.

This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

TypeModifierFlags

type modifier flags of the evaluation result. This overrides the DkmEvaluationResultTypeModifierFlags of the final evaluation result. Use DkmEvaluationResultTypeModifierFlags::None to defer to that of the final evaluation result.

This API was introduced in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).

UniqueId

Guid which uniquely identifies this evaluation result.

(Inherited from DkmEvaluationResult)

Methods

Close()

Closes the evaluation result object to release the resources associated with it. This method must be invoked by the component which initiated the enumeration (ex: called DkmInspectionContext.EvaluateExpression, DkmEvaluationResultEnumContext.GetItems, etc).

DkmEvaluationResult objects are automatically closed when their associated DkmInspectionSession object is closed.

(Inherited from DkmEvaluationResult)
Create(DkmInspectionContext, DkmStackWalkFrame, String, String, DkmDataItem)

Create a new DkmIntermediateEvaluationResult object instance.

Create(DkmInspectionContext, DkmStackWalkFrame, String, String, String, DkmLanguage, DkmRuntimeInstance, DkmDataItem)

Create a new DkmIntermediateEvaluationResult object instance.

This API was introduced in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

Create(DkmInspectionContext, DkmStackWalkFrame, String, String, String, DkmLanguage, DkmRuntimeInstance, DkmEvaluationResultCategory, DkmDataItem)

Create a new DkmIntermediateEvaluationResult object instance.

This API was introduced in Visual Studio 14 Update 1 (DkmApiVersion.VS14Update1).

Create(DkmInspectionContext, DkmStackWalkFrame, String, String, String, DkmLanguage, DkmRuntimeInstance, DkmEvaluationResultCategory, DkmEvaluationResultAccessType, DkmEvaluationResultStorageType, DkmEvaluationResultTypeModifierFlags, DkmDataItem)

Create a new DkmIntermediateEvaluationResult object instance.

This API was introduced in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).

CreateObjectId()

Creates an object id for this particular expression.

Location constraint: IDE components may call this method regardless of what type of code is being debugged. This method is also currently supported for debug monitor components, when debugging code running under the CLR; however this functionality may be removed in a future version.

(Inherited from DkmEvaluationResult)
DestroyObjectId()

Destroys an object id for this particular expression.

Location constraint: IDE components may call this method regardless of what type of code is being debugged. This method is also currently supported for debug monitor components, when debugging code running under the CLR; however this functionality may be removed in a future version.

(Inherited from DkmEvaluationResult)
GetChildren(DkmWorkList, Int32, DkmInspectionContext, DkmCompletionRoutine<DkmGetChildrenAsyncResult>)

Gets an enumeration context used to obtain the children of this evaluation result. This is used in all expression evaluation windows.

This method will append a new work item to the specified work list, and return once the work item has been appended. The actual processing of the work item is asynchronous. The caller will be notified that the request is complete through the completion routine.

Location constraint: IDE components may call this method regardless of what type of code is being debugged. This method is also currently supported for debug monitor components, when debugging code running under the CLR; however this functionality may be removed in a future version.

(Inherited from DkmEvaluationResult)
GetDataItem<T>()

Gets the instance of 'T' which has been added to this container instance. If this container does not contain a 'T', this function will return null.

(Inherited from DkmDataContainer)
GetUnderlyingString()

This method is used for evaluation results that include DkmEvaluationResultFlags.RawString to obtain the the underlying string, with no enclosing quotes or escape sequences. This is method is invoked to display one of the various string visualizers in an expression evaluation window (click the magnifying glass icon).

Location constraint: IDE components may call this method regardless of what type of code is being debugged. This method is also currently supported for debug monitor components, when debugging code running under the CLR; however this functionality may be removed in a future version.

(Inherited from DkmEvaluationResult)
RemoveDataItem<T>()

Remove the instance of 'T' from this container. It is usually unnecessary to call this method as a data container will automatically be emptied when the object is closed.

(Inherited from DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)

Place a new item in the data container.

(Inherited from DkmDataContainer)
SetValueAsString(String, Int32, String)

Modifies the value of the given evaluation result (assumed to be non-read-only) to match the given string. This is used after the user edits a value in any of the evaluation windows.

Location constraint: IDE components may call this method regardless of what type of code is being debugged. This method is also currently supported for debug monitor components, when debugging code running under the CLR; however this functionality may be removed in a future version.

(Inherited from DkmEvaluationResult)

Explicit Interface Implementations

IDisposable.Dispose() (Inherited from DkmEvaluationResult)

Applies to