DkmEngineSettings Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Obsahuje nastavení ladění pro celou relaci. Existuje jedna instance tohoto objektu na identifikátor GUID modulu (příklad: jedna instance pro COMPlusOnlyEng2, jedna instance pro 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 DkmDataContainer
Public Class DkmEngineSettings
Inherits DkmDataContainer
- Dědičnost
- Dědičnost
- Atributy
Vlastnosti
AllowOutOfProcessSymbolLoading |
Pokud je hodnota true, ladicí program načte nativní symboly v samostatném procesu. Toto rozhraní API bylo představeno v sadě Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview). |
BaseDebugMonitorId |
Základní ladicí monitor používaný tímto modulem. Tato hodnota může být Guid.Empty (GUID_NULL), pokud modul může v závislosti na procesu, který se ladí, používat různé základní monitorování ladění. |
ClrDebuggingServicesId |
Určuje, která verze služeb ladění CLR (mscordbi.dll nebo jiné implementace rozhraní API ICorDebug) by se měla použít při ladění tohoto procesu. |
DataBreakpointAsString |
Pokud se zarážky dat mají popisovače považovat za řetězce. Toto rozhraní API bylo představeno v sadě Visual Studio 16 RTM (DkmApiVersion.VS16RTM). |
DotnetVisualizerExtensionInfos |
[Volitelné] Obsahuje relevantní informace o vizualizérech vlastního ladicího programu .NET, které byly nainstalovány prostřednictvím balíčků VSIX a které spravuje Správce částí rozšíření. Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6). |
EnableAsyncDebugging |
Umožňuje krokování příkazů await a krokování z asynchronních metod. Ve výchozím nastavení je tato možnost zapnutá. |
EnableFuncEvalQuickAbort |
Určuje, jestli je pro tento modul povolená funkce FEQA pro tuto ladicí relaci. |
EngineId |
Jedná se o standardní hodnoty GUID modulu. Očekává se, že se tento seznam časem bude rozšiřovat, takže pokud je to možné, doporučujeme místo porovnání EngineId dotazovat na nastavení. |
Flags |
Příznaky, které označují neměnné vlastnosti tohoto nastavení modulu. |
FuncEvalAbortLoggingLevel |
Používá se k označení, jestli se má vytvořit výpis ladicí sady při přerušení nebo hrubém přerušení func eval. Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 Update 4 (DkmApiVersion.VS15Update4). |
FuncEvalQuickAbortExcludeList |
Seznam spustitelných souborů, pro které není povolená funkce FEQA, i když jsou načteny knihovny DLL FEQA. |
ImageDebugDirectoryFormats |
Seznam podporovaných hodnot pro IMAGE_DEBUG_DIRECTORY Typ. |
IsAutomaticDecompilationEnabled |
Pokud je hodnota true, moduly mohou být dekompilovány automaticky, pokud informace o symbolu nejsou k dispozici z jiných zdrojů. Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7). |
IsEditAndContinue |
Povolí možnost Upravit a pokračovat. Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 RTM (DkmApiVersion.VS12RTM). |
IsFastEvaluateAllowed |
Při hodnotě true (výchozí stav) se inspektor CLR pokusí v některých případech interpretovat jednoduché vlastnosti/metody místo použití příkazu func-eval. Složitější metody budou stále vyhodnoceny pomocí func-eval. Toto rozhraní API bylo představeno v sadě Visual Studio 16 Update 2 (DkmApiVersion.VS16Update2). |
IsGpuRaceHazardsAllowSameSettingEnabled |
Pokud je hodnota true, ladicí program ignoruje nebezpečí závodu GPU, která nezměnila předchozí data. |
IsJustMyCodeEnabled |
Pokud je hodnota true, ladicí program povolí funkce JustMyCode (krokování, zásobník volání a filtrování výjimek). |
IsNativeExportsEnabled |
Pokud je hodnota true, ladicí program se pokusí použít tabulky exportu ze souborů Win32 PE k překladu adres. |
IsNativeJustMyCodeSteppingEnabled |
Pokud je hodnota true, ladicí program povolí krokování jen mého kódu pro nativní (při kompilaci modulu s přepínačem /JMC). Toto rozhraní API bylo zavedeno v sadě Visual Studio 15 Update 8 (DkmApiVersion.VS15Update8). |
IsStepOverPropertiesAndOperatorsEnabled |
Pokud je hodnota true, ladicí program krokuje vlastnosti a operátory po dokončení kroku v kroku. |
IsSuppressOptimizationsEnabled |
Pokud je hodnota true, ladicí program potlačí optimalizace kompilátoru za běhu pro nově načtené moduly. |
IsUnloaded |
Vrátí hodnotu true, pokud byla pro tento objekt vyvolána událost unloaded (příklad: DkmThread::Unload je volána) nebo pokud byl objekt uzavřen. Mějte na paměti, že při kontrole tohoto stavu je potřeba střídmět, protože bez synchronizace nemusí být vrácený stav po přečtení přesný. (Zděděno od DkmDataContainer) |
Languages |
Kolekce všech programovacích jazyků podporovaných při ladění tohoto procesu |
MaxCallStackFrames |
Maximální počet rámců podporovaných v okně zásobníku volání. Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 RTM (DkmApiVersion.VS12RTM). |
NativeEESettings |
[Volitelné] Obsahuje nastavení konfigurace nativního vyhodnocovače výrazů. Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7). |
RegistryTweaks |
[Volitelné] Seznam vylepšení registru v registru sady Visual Studio, které komponenty mohou použít k přizpůsobení jejich chování. Vylepšení registru se načítají z klíče [Kořen registru sady Visual Studio]\Debugger\EngineSwitches na začátku každé ladicí relace. Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 RTM (DkmApiVersion.VS12RTM). |
RemoteClrPdbNamePatterns |
Seznam vzorů názvů PDB sloužících k určení, jestli se soubor PDB načte na vzdálené straně. |
RequireFullTrustForSourceServer |
Pokud je hodnota true, ladicí program bude vyžadovat, aby sestavení byla plně důvěryhodná před spuštěním příkazů zdrojového serveru ze sestavení. Koncept plně důvěryhodné se vztahuje pouze na sestavení CLR. |
SymbolPaths |
Kolekce DkmStrings představující cesty pro vyhledávání symbolů a cestu k mezipaměti. |
TraceSettings |
[Volitelné] Nastavení trasování pro výstup WPF. Toto rozhraní API bylo zavedeno v sadě Visual Studio 14 RTM (DkmApiVersion.VS14RTM). |
ValidateFilesForMinidumps |
Hodnota True, pokud má ladicí program ověřit digitální podpisy knihoven ladění CLR před jejich načtením. Všimněte si, že bez ohledu na název se toto nastavení ve skutečnosti používá pro všechny typy ladění. Toto rozhraní API bylo zavedeno v sadě Visual Studio 12 RTM (DkmApiVersion.VS12RTM). |
Metody
FindProcess(Guid) |
Vyhledejte prvek DkmProcess v tomto DkmEngineSettings. Pokud není k dispozici žádný prvek se zadaným vstupním klíčem, FindProcess selže. |
FindSettings(Guid) |
Vyhledejte objekt DkmEngineSettings. Pokud není k dispozici žádný objekt s daným vstupním klíčem, FindSettings selže. |
GetCodeViewCompilers() |
Vrátí výčet DkmCodeViewCompilerId hodnot. Tento výčet pak může použít zprostředkovatel symbolů k mapování informací v záznamu zobrazení kódu na strukturu DkmCompilerId. |
GetCorDumpAdditionalClrRuntimePaths(ReadOnlyCollection<String>) |
Získejte další cesty modulu runtime CLR. Toto rozhraní API bylo představeno v sadě Visual Studio 17 Update 1 (DkmApiVersion.VS17Update1). |
GetDataItem<T>() |
Získá instanci T, která byla přidána do této instance kontejneru. Pokud tento kontejner neobsahuje T, vrátí tato funkce hodnotu null. (Zděděno od DkmDataContainer) |
GetLanguage(DkmCompilerId) |
Vrátí DkmLanguage objekt, který odpovídá danému ID kompilátoru. Pokud je jazyk neznámý (není zaregistrovaný v modulu), vrátí tato metoda výchozí objekt jazyka. |
GetProcesses() |
GetProcesses vytvoří výčet prvků DkmProcess tohoto DkmEngineSettings objektu. |
GetSettings() |
GetSettings vytvoří výčet všech vytvořených objektů DkmEngineSettings. |
GetUserDocumentPath() |
Získejte cestu ke složce uživatelského dokumentu sady Visual Studio. |
RemoveDataItem<T>() |
Odeberte z tohoto kontejneru instanci T. Obvykle není nutné volat tuto metodu, protože kontejner dat se při zavření objektu automaticky vyprázdní. (Zděděno od DkmDataContainer) |
SetDataItem<T>(DkmDataCreationDisposition, T) |
Do kontejneru dat umístěte novou položku. (Zděděno od DkmDataContainer) |