DkmSuccessEvaluationResult 類別

參考

定義

命名空間:: Microsoft.VisualStudio.Debugger.Evaluation

組件:: Microsoft.VisualStudio.Debugger.Engine.dll

套件:: Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

成功評估的格式化結果，準備好顯示在表達式評估視窗中。

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

繼承: MarshalByRefObject

DkmDataContainer

DkmEvaluationResult
DkmSuccessEvaluationResult

繼承: Object

DkmDataContainer

DkmEvaluationResult
DkmSuccessEvaluationResult

屬性: GuidAttribute

屬性

Access	訪問控制層級 (評估結果的公用、私人等) 。
Address	[選擇性]如果結果是位址 (，亦即位址旗標是在 Flags) 中設定，則指定備份值的位置。當評估結果做為記憶體視窗或反組譯碼視窗的輸入時，就會使用這個值。如果是指令位址，則必須設定 CPUInstruction 位址。
Category	此評估結果的類別 (例如：數據、方法等) 。
CustomUIVisualizers	[選擇性]這個物件的自定義查看器清單。
EditableValue	[選擇性]如果值是可寫入的，請指定當您按兩下值來編輯它時要使用的預設字串。 EE 應該能夠剖析並評估此字串，並取得目前的評估結果。如果值為只讀，則會忽略可編輯的值，而且應該是 Null。
ExternalModules	[選擇性]如果有的話，外部模組的清單，不包括用於檢查物件的目前模組。載入此清單中的模組數目盡可能多的符號，將會增強對象的顯示。
Flags	表示表達式評估結果屬性的旗標。
FullName	[選擇性]此結果所套用之表達式的完整名稱。這個值可用來允許子元素加入至 watch 視窗， (從操作功能表) 新增監看式，以及重新整理評估樹狀結構的元件。作為 FullName 與名稱不同之範例，C++ 中陣列的第 0 個元素名稱是 '[0]'，而完整名稱則為 'myArrayVariable[0]'。若為 Visual Studio 14 和更新版本，可以視需要稍後計算完整名稱。若要這樣做，表達式評估工具應該使用 Null 完整名稱建立 DkmEvaluationResult，並實作 IDkmFullNameProvider。 Concord 接著會呼叫 IDkmFullNameProvider.CalculateFullName，以在需要時在 UI 中取得完整名稱。 (繼承來源 DkmEvaluationResult)
InspectionContext	用來建立此評估結果的檢查內容。 (繼承來源 DkmEvaluationResult)
InspectionSession	InspectionSession 可讓各種元件檢查目標進程中的數據，以儲存具有相同存留期的私人數據。當使用者嘗試繼續此程式時，會關閉檢查會話。 (繼承來源 DkmEvaluationResult)
IsUnloaded	如果已針對這個對象引發 'unloaded' 事件，則傳回 true (範例：DkmThread：：Unload 會呼叫) 或物件已關閉。請注意，檢查此狀態時必須小心，而不進行同步處理，傳回的狀態在讀取之後可能無法再精確指示。 (繼承來源 DkmDataContainer)
Language	用來執行檢查的語言。 (繼承來源 DkmEvaluationResult)
Name	此結果所套用的運算式名稱。 (繼承來源 DkmEvaluationResult)
RefreshButtonText	[選擇性]設定 DkmEvaluationResultFlags：：CanEvaluateNow 時，指定當使用者將滑鼠停留在重新整理按鈕上方時，要顯示為工具提示的文字。如果此值為 Null，則會使用預設訊息。此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。
RuntimeInstance	指出將用來執行此評估的運行時間監視器。 (繼承來源 DkmEvaluationResult)
StackFrame	建立此表達式結果的堆疊框架。 (繼承來源 DkmEvaluationResult)
StorageType	記憶體類型 (例如：評估結果的靜態) 。
TagValue	DkmEvaluationResult 是抽象基類。這個列舉表示這個物件的衍生類別是的實例。 (繼承來源 DkmEvaluationResult)
Type	[選擇性]描述值型別的字串。
TypeModifierFlags	類型修飾詞旗標 (例如：評估結果的 const) 。
UniqueId	可唯一識別此評估結果的 Guid。 (繼承來源 DkmEvaluationResult)
Value	[選擇性]描述值的字串。

方法

AddToFavorites(DkmSuccessEvaluationResult)	將指定的子系加入至此結果類型的我的最愛專案集合。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 16 Update 4 (DkmApiVersion.VS16Update4) 引進。
Close()	關閉評估結果物件以釋放與其相關聯的資源。這個方法必須由起始列舉 (的元件叫用，例如：稱為 DkmInspectionContext.EvaluateExpression、DkmEvaluationResultEnumContext.GetItems 等) 。當相關聯的 DkmInspectionSession 物件關閉時，會自動關閉 DkmEvaluationResult 物件。 (繼承來源 DkmEvaluationResult)
Create(DkmInspectionContext, DkmStackWalkFrame, String, String, DkmEvaluationResultFlags, String, String, String, DkmEvaluationResultCategory, DkmEvaluationResultAccessType, DkmEvaluationResultStorageType, DkmEvaluationResultTypeModifierFlags, DkmDataAddress, ReadOnlyCollection<DkmCustomUIVisualizerInfo>, ReadOnlyCollection<DkmModuleInstance>, DkmDataItem)	Create 新的 DkmSuccessEvaluationResult 對象實例。
Create(DkmInspectionContext, DkmStackWalkFrame, String, String, DkmEvaluationResultFlags, String, String, String, DkmEvaluationResultCategory, DkmEvaluationResultAccessType, DkmEvaluationResultStorageType, DkmEvaluationResultTypeModifierFlags, DkmDataAddress, ReadOnlyCollection<DkmCustomUIVisualizerInfo>, ReadOnlyCollection<DkmModuleInstance>, String, DkmDataItem)	Create 新的 DkmSuccessEvaluationResult 對象實例。此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。
CreateDebuggeeSideVisualizerObject(DkmWorkList, UInt32, DkmCompletionRoutine<DkmCreateDebuggeeSideVisualizerObjectAsyncResult>)	在偵錯程式中具現化 debuggee 端自定義可視化檢視類型。這個方法會將新的工作專案附加至指定的工作清單，並在附加工作項目之後傳回。工作項目的實際處理是異步的。呼叫端將會透過完成例程收到要求完成的通知。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 16 Update 10 (DkmApiVersion.VS16Update10) 引進。
CreateDebuggeeSideVisualizerObject(DkmWorkList, UInt32, Int32, DkmCompletionRoutine<DkmCreateDebuggeeSideVisualizerObject176AsyncResult>)	具現化偵錯程式程式中的debuggee端自定義可視化檢視類型，並指定與偵錯程式通訊時應該使用的串行化類型。這個方法會將新的工作專案附加至指定的工作清單，並在附加工作項目之後傳回。工作項目的實際處理是異步的。呼叫端將會透過完成例程收到要求完成的通知。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6) 引進。
CreateDebuggeeSideVisualizerObject(UInt32, Int32, Int32, String, String, String, Boolean)	具現化偵錯程式程式中的debuggee端自定義可視化檢視類型，並指定與偵錯程式通訊時應該使用的串行化類型。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6) 引進。
CreateDebuggeeSideVisualizerObject(UInt32, String, String, String)	在偵錯程式中具現化 debuggee 端自定義可視化檢視類型。注意：這個方法已被取代，而偏好在 IDkmClrCustomVisualizerObjectProvider1610 介面中定義的介面。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引進。
CreateDebuggeeSideVisualizerObject(UInt32, String, String, String, Boolean)	在偵錯程式中具現化 debuggee 端自定義可視化檢視類型。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 16 Update 10 (DkmApiVersion.VS16Update10) 引進。
CreateObjectId()	建立這個特定表達式的物件識別碼。位置條件約束：不論正在偵錯的程式代碼類型為何，IDE 元件都可以呼叫此方法。偵錯在 CLR 下執行的程式代碼時，目前也支援偵錯監視元件的方法;不過，未來版本可能會移除這項功能。 (繼承來源 DkmEvaluationResult)
CreateReplacementObjectOnDebuggeeSideVisualizer(Byte[], String, String, String)	執行 debuggee 端自定義可視化檢視類型的 CreateReplacementObject (...) 方法，並將結果寫入可視化的物件句柄。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引進。
DestroyDebuggeeSideVisualizerObject()	釋放偵錯範圍程式中的偵錯專案端自定義可視化檢視類型。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引進。
DestroyDebuggeeSideVisualizerObject(DkmWorkList, DkmCompletionRoutine<DkmDestroyDebuggeeSideVisualizerObjectAsyncResult>)	釋放偵錯範圍程式中的偵錯專案端自定義可視化檢視類型。這個方法會將新的工作專案附加至指定的工作清單，並在附加工作項目之後傳回。工作項目的實際處理是異步的。呼叫端將會透過完成例程收到要求完成的通知。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引進。
DestroyObjectId()	終結這個特定表達式的物件標識符。位置條件約束：不論正在偵錯的程式代碼類型為何，IDE 元件都可以呼叫此方法。偵錯在 CLR 下執行的程式代碼時，目前也支援偵錯監視元件的方法;不過，未來版本可能會移除這項功能。 (繼承來源 DkmEvaluationResult)
ExtractFromProperty(IDebugProperty3)	會取得會備份 IDebugProperty3 物件的 DkmSuccessEvaluationResult 物件。此 API 只會從 Visual Studio 的主線程正確運作。
GetChildren(DkmWorkList, Int32, DkmInspectionContext, DkmCompletionRoutine<DkmGetChildrenAsyncResult>)	取得用來取得這個評估結果子系的列舉內容。這適用於所有表達式評估視窗。這個方法會將新的工作專案附加至指定的工作清單，並在附加工作項目之後傳回。工作項目的實際處理是異步的。呼叫端將會透過完成例程收到要求完成的通知。位置條件約束：不論正在偵錯的程式代碼類型為何，IDE 元件都可以呼叫此方法。偵錯在 CLR 下執行的程式代碼時，目前也支援偵錯監視元件的方法;不過，未來版本可能會移除這項功能。 (繼承來源 DkmEvaluationResult)
GetClrValue()	如果存在，則從 DkmSuccessEvaluationResult 取得基礎 DkmClrValue。位置條件約束：必須從監視元件呼叫 API， (元件層級 < 100,000) 。此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引進。
GetDataBreakpointDisplayName()	取得評估結果的數據斷點顯示名稱。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 16 RTM (DkmApiVersion.VS16RTM) 中引進。
GetDataBreakpointDisplayName(DkmWorkList, DkmCompletionRoutine<DkmGetDataBreakpointDisplayNameAsyncResult>)	取得評估結果的數據斷點顯示名稱。這個方法會將新的工作專案附加至指定的工作清單，並在附加工作項目之後傳回。工作項目的實際處理是異步的。呼叫端將會透過完成例程收到要求完成的通知。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 16 RTM (DkmApiVersion.VS16RTM) 中引進。
GetDataBreakpointInfo(DkmWorkList, DkmCompletionRoutine<DkmGetDataBreakpointInfoAsyncResult>)	如果有效，則傳回與評估結果相關的數據斷點資訊。這個方法會將新的工作專案附加至指定的工作清單，並在附加工作項目之後傳回。工作項目的實際處理是異步的。呼叫端將會透過完成例程收到要求完成的通知。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 15 Update 8 (DkmApiVersion.VS15Update8) 引進。
GetDataBreakpointInfo(String)	如果有效，則傳回與評估結果相關的數據斷點資訊。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 15 Update 8 (DkmApiVersion.VS15Update8) 引進。
GetDataFromDebuggeeSideVisualizer(DkmWorkList, DkmCompletionRoutine<DkmGetDataFromDebuggeeSideVisualizerAsyncResult>)	執行 debuggee 端自定義可視化檢視類型的 GetData (...) 方法。這個方法會將新的工作專案附加至指定的工作清單，並在附加工作項目之後傳回。工作項目的實際處理是異步的。呼叫端將會透過完成例程收到要求完成的通知。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引進。
GetDataFromDebuggeeSideVisualizer(String, String, String)	執行 debuggee 端自定義可視化檢視類型的 GetData (...) 方法。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引進。
GetDataItem<T>()	取得已新增至這個容器實例的『T』實例。如果此容器不包含『T』，此函式會傳回 null。 (繼承來源 DkmDataContainer)
GetUnderlyingString()	這個方法用於包含 DkmEvaluationResultFlags.RawString 的評估結果，以取得基礎字串，不含括住引號或逸出序列。這是叫用方法來在表達式評估視窗中顯示其中一個各種字串可視化檢視， (按兩下放大鏡圖示) 。位置條件約束：不論正在偵錯的程式代碼類型為何，IDE 元件都可以呼叫此方法。偵錯在 CLR 下執行的程式代碼時，目前也支援偵錯監視元件的方法;不過，未來版本可能會移除這項功能。 (繼承來源 DkmEvaluationResult)
RemoveDataItem<T>()	從這個容器中移除『T』的實例。通常不需要呼叫這個方法，因為數據容器會在物件關閉時自動清空。 (繼承來源 DkmDataContainer)
RemoveFromFavorites(DkmSuccessEvaluationResult)	從這個結果類型的我的最愛專案集合中移除指定的子系。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 16 Update 4 (DkmApiVersion.VS16Update4) 引進。
ResolveAssembly(String, String, ReadOnlyCollection<Byte>)	將元件名稱解析為元件的路徑或其原始位元組。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引進。
SetDataItem<T>(DkmDataCreationDisposition, T)	將新專案放在數據容器中。 (繼承來源 DkmDataContainer)
SetValueAsString(String, Int32, String)	修改指定評估結果的值， (假設為非只讀) ，以符合指定的字串。這會在用戶編輯任何評估視窗中的值之後使用。位置條件約束：不論正在偵錯的程式代碼類型為何，IDE 元件都可以呼叫此方法。偵錯在 CLR 下執行的程式代碼時，目前也支援偵錯監視元件的方法;不過，未來版本可能會移除這項功能。 (繼承來源 DkmEvaluationResult)
TransferDataToDebuggeeSideVisualizer(Byte[], String, String, String)	執行 debuggee 端自定義可視化檢視類型的 TransferData (...) 方法。位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引進。

明確介面實作

IDisposable.Dispose()

成功評估的格式化結果，準備好顯示在表達式評估視窗中。

(繼承來源 DkmEvaluationResult)

適用於