DkmEngineSettings 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
包含整個工作階段的偵錯設定。 每個引擎 Guid 有一個實例 (例如：一個 COMPlusOnlyEng2 實例，一個實例用於 COMPlusNativeEng) 。
public ref class DkmEngineSettings : Microsoft::VisualStudio::Debugger::DkmDataContainer[System.Runtime.InteropServices.Guid("3c1f22df-556c-18bf-7584-c2c649777bfe")]
public class DkmEngineSettings : Microsoft.VisualStudio.Debugger.DkmDataContainer[<System.Runtime.InteropServices.Guid("3c1f22df-556c-18bf-7584-c2c649777bfe")>]
type DkmEngineSettings = class
inherit DkmDataContainerPublic Class DkmEngineSettings
Inherits DkmDataContainer- 繼承
- 繼承
- 屬性
屬性
| AllowOutOfProcessSymbolLoading |
若為 true，調試程式會在個別進程中載入原生符號。 此 API 是在 Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) 中引進。 |
| BaseDebugMonitorId |
此引擎所使用的基底偵錯監視器。 如果引擎可能會根據正在偵錯的進程使用各種基底偵錯監視器，此值可能是 Guid.Empty (GUID_NULL) 。 |
| ClrDebuggingServicesId |
指出偵錯此程式時，應該使用哪個版本的 CLR 偵錯服務 (mscordbi.dll 或其他 ICorDebug API 實作) 。 |
| DataBreakpointAsString |
如果數據斷點描述元應視為字串。 此 API 是在 Visual Studio 16 RTM (DkmApiVersion.VS16RTM) 中引進。 |
| DotnetVisualizerExtensionInfos |
[選擇性]保留透過 VSIX 套件安裝的 .NET 自定義調試程式可視化檢視相關信息，並由延伸模組元件管理員管理。 此 API 是在 Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6) 引進。 |
| EnableAsyncDebugging |
可讓您逐步執行 'await' 語句，並跳出異步方法。 默認為開啟狀態。 |
| EnableFuncEvalQuickAbort |
指定是否為此偵錯會話啟用此引擎的FEQA。 |
| EngineId |
這些是「標準」引擎 GUID 值。 預期此清單會隨著時間成長，因此在可能的情況下，建議您查詢設定，而不是比較 EngineId。 |
| Flags |
指出此引擎設定不可變特性的旗標。 |
| FuncEvalAbortLoggingLevel |
用來指出當 func eval 中止或粗略中止時，是否要建立偵錯範圍的傾印。 此 API 是在 Visual Studio 15 Update 4 (DkmApiVersion.VS15Update4) 中引進。 |
| FuncEvalQuickAbortExcludeList |
即使載入 FEQA DLL，也不會啟用 FEQA 的可執行檔案清單。 |
| ImageDebugDirectoryFormats |
IMAGE_DEBUG_DIRECTORY支援的值清單。類型。 |
| IsAutomaticDecompilationEnabled |
如果為 true，當符號資訊無法從其他來源使用時，可能會自動反編譯模組。 此 API 是在 Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7) 中引進。 |
| IsEditAndContinue |
啟用 [編輯後繼續]。 此 API 是在 Visual Studio 12 RTM (DkmApiVersion.VS12RTM) 引进。 |
| IsFastEvaluateAllowed |
當 true (預設狀態) 時，CLR 偵測器會嘗試在某些情況下解譯簡單的屬性/方法，而不是使用 func-eval。 仍然會使用 func-eval 評估更複雜的方法。 此 API 是在 Visual Studio 16 Update 2 (DkmApiVersion.VS16Update2) 引進。 |
| IsGpuRaceHazardsAllowSameSettingEnabled |
若為 true，調試程式將會忽略未變更先前數據的 GPU 競爭障礙。 |
| IsJustMyCodeEnabled |
若為 true，調試程式將會啟用 JustMyCode 功能， (逐步執行、呼叫堆棧和例外狀況篩選) 。 |
| IsNativeExportsEnabled |
若為 true，調試程式將會嘗試使用來自 Win32 PE 檔案的匯出數據表來解析位址。 |
| IsNativeJustMyCodeSteppingEnabled |
若為 true，調試程式會在使用 /JMC 參數編譯模組時啟用原生 (的 Just My Code 逐步執行) 。 此 API 是在 Visual Studio 15 Update 8 (DkmApiVersion.VS15Update8) 引進。 |
| IsStepOverPropertiesAndOperatorsEnabled |
若為 true，調試程式會在完成步驟時逐步執行屬性和運算符。 |
| IsSuppressOptimizationsEnabled |
若為 true，調試程式將會隱藏新載入模組的 Just-In-Time 編譯程序優化。 |
| IsUnloaded |
如果已針對這個對象引發 'unloaded' 事件，則傳回 true (範例：DkmThread：：Unload 會呼叫) 或物件已關閉。 請注意，檢查此狀態時必須小心，而不進行同步處理，傳回的狀態在讀取之後可能無法再精確指示。 (繼承來源 DkmDataContainer) |
| Languages |
偵錯此程式時支援的所有程式設計語言集合。 |
| MaxCallStackFrames |
呼叫堆疊視窗中支援的框架數目上限。 此 API 是在 Visual Studio 12 RTM (DkmApiVersion.VS12RTM) 引进。 |
| NativeEESettings |
[選擇性]包含原生表達式評估工具的組態設定。 此 API 是在 Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7) 中引進。 |
| RegistryTweaks |
[選擇性]Visual Studio 登錄中的登錄調整清單，元件可用來自定義其行為。 登錄調整是從每個偵錯會話開頭的機碼 [Visual Studio Registry Root]\Debugger\EngineSwitches 讀取。 此 API 是在 Visual Studio 12 RTM (DkmApiVersion.VS12RTM) 引进。 |
| RemoteClrPdbNamePatterns |
用來判斷 PDB 是否會在遠端載入 PDB 的名稱模式清單。 |
| RequireFullTrustForSourceServer |
如果為 true，調試程式需要元件完全信任，才能從元件執行來源伺服器命令。 完全信任的概念僅適用於 CLR 元件。 |
| SymbolPaths |
DkmStrings 的集合，代表符號搜尋路徑和快取路徑。 |
| TraceSettings |
[選擇性]WPF 輸出的追蹤設定。 此 API 是在 Visual Studio 14 RTM (DkmApiVersion.VS14RTM) 中引進。 |
| ValidateFilesForMinidumps |
如果調試程式應該在載入 CLR 偵錯連結庫之前驗證數位簽名，則為 True。 請注意，雖然名稱相同，但此設定實際上用於所有類型的偵錯。 此 API 是在 Visual Studio 12 RTM (DkmApiVersion.VS12RTM) 引进。 |
方法
| FindProcess(Guid) |
在此 DkmEngineSettings 中尋找 DkmProcess 元素。 如果沒有具有指定輸入索引鍵的專案存在，FindProcess 將會失敗。 |
| FindSettings(Guid) |
尋找 DkmEngineSettings 物件。 如果沒有具有指定輸入索引鍵的物件存在，FindSettings 將會失敗。 |
| GetCodeViewCompilers() |
傳回 DkmCodeViewCompilerId 值的列舉。 然後，符號提供者可以使用這個列舉，將程式代碼檢視記錄內的資訊對應至 DkmCompilerId 結構。 |
| GetCorDumpAdditionalClrRuntimePaths(ReadOnlyCollection<String>) |
取得其他 Clr 執行時間路徑。 此 API 是在 Visual Studio 17 Update 1 (DkmApiVersion.VS17Update1) 引進。 |
| GetDataItem<T>() |
取得已新增至這個容器實例的 『T』 實例。 如果此容器不包含 『T』，此函式會傳回 null。 (繼承來源 DkmDataContainer) |
| GetLanguage(DkmCompilerId) |
會傳回符合指定編譯程式標識碼的 DkmLanguage 物件。如果語言未知 (未向引擎註冊) ，則此方法會傳回預設語言物件。 |
| GetProcesses() |
GetProcesses 會列舉這個 DkmEngineSettings 物件的 DkmProcess 元素。 |
| GetSettings() |
GetSettings 會列舉所有已建立的 DkmEngineSettings 物件。 |
| GetUserDocumentPath() |
取得使用者檔 Visual Studio 資料夾路徑。 |
| RemoveDataItem<T>() |
從這個容器中移除 『T』 的實例。 通常不需要呼叫這個方法，因為數據容器會在物件關閉時自動清空。 (繼承來源 DkmDataContainer) |
| SetDataItem<T>(DkmDataCreationDisposition, T) |
將新專案放在數據容器中。 (繼承來源 DkmDataContainer) |