DkmInspectionContext 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
執行檢查作業時要使用的選項和目標內容。
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 = classPublic Class DkmInspectionContext- 繼承
-
DkmInspectionContext
- 屬性
屬性
| 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，這會指定處理此檢查作業之符號的背景工作進程連線。 如果在 IDE 進程中載入符號，或是在遠端調試程式中載入符號，則為 null， (DkmModule.Connection 為非 Null) 。 此 API 是在 Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) 中引進。 |
| Thread |
正在檢查的線程。 |
| Timeout |
這是用於函式評估等可能緩慢作業的逾時。 這個值是以毫秒為單位。 |
方法
| ClrExpressionMayRequireParentheses(String) |
如果在語言中當做子表達式使用時，表達式可能需要括弧，則傳回 true。 位置條件約束：必須從監視器元件 (元件層級 < 100,000) 呼叫 API。 此 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 視窗、實時視窗等。 這個方法會將新的工作專案附加至指定的工作清單，並在附加工作項目之後傳回 。 工作項目的實際處理是異步的。 呼叫端將會透過完成例程收到要求完成的通知。 位置條件約束：不論正在偵錯的程式代碼類型為何，IDE 元件都可以呼叫此方法。 偵錯在 CLR 下執行的程式代碼時，目前也支援偵錯監視元件的方法;不過，未來版本可能會移除這項功能。 |
| EvaluateExpressionOnThreads(DkmWorkList, ReadOnlyCollection<UInt64>, DkmStackWalkFrame, DkmLanguageExpression, DkmCompletionRoutine<DkmEvaluateExpressionOnThreadsAsyncResult>) |
系結輸入表達式並評估它。 然後，將產生的值格式化，以在調試程序中顯示。 這用於數據提示、watch 視窗、實時視窗等。 這個方法會將新的工作專案附加至指定的工作清單，並在附加工作項目之後傳回 。 工作項目的實際處理是異步的。 呼叫端將會透過完成例程收到要求完成的通知。 位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。 |
| EvaluateReturnValue(DkmWorkList, DkmStackWalkFrame, DkmRawReturnValue, DkmCompletionRoutine<DkmEvaluateReturnValueAsyncResult>) |
只使用所提供的數據來評估並格式化指定的 DkmRawReturnValue。 這個方法會將新的工作專案附加至指定的工作清單，並在附加工作項目之後傳回 。 工作項目的實際處理是異步的。 呼叫端將會透過完成例程收到要求完成的通知。 位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。 |
| EvaluateReturnValue2(DkmWorkList, DkmStackWalkFrame, DkmRawReturnValueContainer, DkmCompletionRoutine<DkmEvaluateReturnValueAsyncResult2>) |
只使用所提供的數據來評估並格式化指定的 DkmRawReturnValue。 這個方法會將新的工作專案附加至指定的工作清單，並在附加工作項目之後傳回 。 工作項目的實際處理是異步的。 呼叫端將會透過完成例程收到要求完成的通知。 位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。 此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引進。 |
| GetClrArrayIndexExpression(String[]) |
取得陣列索引表達式。 位置條件約束：必須從監視器元件 (元件層級 < 100,000) 呼叫 API。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| GetClrCastExpression(String, DkmClrType, DkmClrCustomTypeInfo, DkmClrCastExpressionOptions) |
如果有效的語法，請取得轉換表達式。 位置條件約束：必須從監視器元件 (元件層級 < 100,000) 呼叫 API。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| GetClrExpressionAndFormatSpecifiers(String, ReadOnlyCollection<String>) |
將字串分割成表達式和格式規範部分。 位置條件約束：必須從監視器元件 (元件層級 < 100,000) 呼叫 API。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| GetClrExpressionForNull() |
取得 null (關鍵詞) 的語言特定表達式。 位置條件約束：必須從監視器元件 (元件層級 < 100,000) 呼叫 API。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| GetClrExpressionForThis() |
取得此/Me 的語言特定表達式。 位置條件約束：必須從監視器元件 (元件層級 < 100,000) 呼叫 API。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| GetClrLocalVariableQuery(DkmClrInstructionAddress, Boolean) |
取得 DkmCompiledClrLocalsQuery 以允許檢視局部變數。 位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。 此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引進。 |
| GetClrMemberName(String, DkmClrType, DkmClrCustomTypeInfo, String, Boolean, Boolean) |
如果成員可以表示為有效的語法，請取得成員存取表達式。 位置條件約束：必須從監視器元件 (元件層級 < 100,000) 呼叫 API。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| GetClrNameForField(DkmClrModuleInstance, Int32) |
從元數據取得標識碼的語言特定名稱。 位置條件約束：必須從監視器元件 (元件層級 < 100,000) 呼叫 API。 此 API 是在 Visual Studio 16 Update 10 (DkmApiVersion.VS16Update10) 引進。 |
| GetClrNameForLocalVariable(DkmClrModuleInstance, DkmClrMethodId, DkmILRange, DkmClrLocalVariable) |
從元數據取得標識碼的語言特定名稱。 位置條件約束：必須從監視器元件 (元件層級 < 100,000) 呼叫 API。 此 API 是在 Visual Studio 16 Update 10 (DkmApiVersion.VS16Update10) 引進。 |
| GetClrObjectCreationExpression(DkmClrType, DkmClrCustomTypeInfo, String[]) |
如果有效的語法，請取得物件建立表達式。 位置條件約束：必須從監視器元件 (元件層級 < 100,000) 呼叫 API。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| GetClrTypeName(DkmClrType, DkmClrCustomTypeInfo) |
如果有效的語法，請以有效的格式取得類型名稱。 這個方法可用來建構有效的完整名稱，而且如果沒有有效的語法，就能夠逸出/傳回 Null。 位置條件約束：必須從監視器元件 (元件層級 < 100,000) 呼叫 API。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| GetClrValidIdentifier(String) |
以語言有效的格式取得識別碼。 位置條件約束：必須從監視器元件 (元件層級 < 100,000) 呼叫 API。 此 API 是在 Visual Studio 15 RTM (DkmApiVersion.VS15RTM) 中引進。 |
| GetFrameArguments(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameArgumentsAsyncResult>) |
提供堆疊框架自變數的相關信息。 這目前只會透過 VS 自動化模型公開， (EnvDTE.StackFrame.Arguments) 。 這個方法會將新的工作專案附加至指定的工作清單，並在附加工作項目之後傳回 。 工作項目的實際處理是異步的。 呼叫端將會透過完成例程收到要求完成的通知。 位置條件約束：不論正在偵錯的程式代碼類型為何，IDE 元件都可以呼叫此方法。 偵錯在 CLR 下執行的程式代碼時，目前也支援偵錯監視元件的方法;不過，未來版本可能會移除這項功能。 |
| GetFrameLocals(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameLocalsAsyncResult>) |
取得列舉內容，用來取得這個堆疊框架的局部變數。 這會用於計算局部變數視窗。 這個方法會將新的工作專案附加至指定的工作清單，並在附加工作項目之後傳回 。 工作項目的實際處理是異步的。 呼叫端將會透過完成例程收到要求完成的通知。 位置條件約束：不論正在偵錯的程式代碼類型為何，IDE 元件都可以呼叫此方法。 偵錯在 CLR 下執行的程式代碼時，目前也支援偵錯監視元件的方法;不過，未來版本可能會移除這項功能。 |
| GetFrameName(DkmWorkList, DkmStackWalkFrame, DkmVariableInfoFlags, DkmCompletionRoutine<DkmGetFrameNameAsyncResult>) |
提供堆疊框架的文字表示。 建置格式化的呼叫堆疊時，會使用此方式。 這個方法會將新的工作專案附加至指定的工作清單，並在附加工作項目之後傳回 。 工作項目的實際處理是異步的。 呼叫端將會透過完成例程收到要求完成的通知。 位置條件約束：不論正在偵錯的程式代碼類型為何，IDE 元件都可以呼叫此方法。 偵錯在 CLR 下執行的程式代碼時，目前也支援偵錯監視元件的方法;不過，未來版本可能會移除這項功能。 |
| GetFrameReturnType(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameReturnTypeAsyncResult>) |
提供一或多個堆疊框架之傳回型別的文字表示。 這目前只會透過 VS 自動化模型公開， (EnvDTE.StackFrame.ReturnType) 。 這個方法會將新的工作專案附加至指定的工作清單，並在附加工作項目之後傳回 。 工作項目的實際處理是異步的。 呼叫端將會透過完成例程收到要求完成的通知。 位置條件約束：必須從 IDE 元件呼叫 API， (元件層級 > 100,000) 。 |
| GetTypeName(DkmClrType, DkmClrCustomTypeInfo, ReadOnlyCollection<String>) |
取得要顯示在指定 DkmClrType UI 中的型別名稱字串。 此方法一律會傳回值，並用於變數檢查視窗。 位置條件約束：必須從監視器元件 (元件層級 < 100,000) 呼叫 API。 此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引進。 |
| WithProperties(UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32) |
使用已更新的屬性建立原始 DkmInspectionContext 的複本，例如 EvaluationFlags 或 Radix。 屬性是原始專案的完整取代，而且不會合併到原始屬性中。 因此，原始 DkmInspectionContext 中的任何所需屬性都必須提供給這個方法。 此 API 是在 Visual Studio 17 Update 8 (DkmApiVersion.VS17Update8) 中引進。 |