DkmInspectionContext Classe

Definizione

Spazio dei nomi:

Microsoft.VisualStudio.Debugger.Evaluation

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Pacchetto:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Opzioni e contesto di destinazione da usare durante l'esecuzione dell'operazione di ispezione.

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 = class

Public Class DkmInspectionContext

Ereditarietà

Object

DkmInspectionContext

Attributi

GuidAttribute

Proprietà

AdditionalVisualizationData	[Facoltativo] Specifica un elenco facoltativo di percorsi completi per i file di visualizzazione da usare, oltre ai file predefiniti dalla directory del profilo utente e dalla directory di installazione di Visual Studio. La precedenza tra i visualizzatori in conflitto in questi percorsi, rispetto ai percorsi standard, viene risolta in base alle informazioni specificate in 'AdditionalVisualizationDataPriority'. Questa API è stata introdotta in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
AdditionalVisualizationDataPriority	Se si specifica AdditionalVisualizationData, specifica la priorità di tali dati rispetto ai percorsi di ricerca predefiniti. Questa API è stata introdotta in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
EvaluationFlags	Flag che influisce sulla modalità di analisi, compilazione o visualizzazione di un'espressione di input.
FuncEvalFlags	Flag che influiscono sulla modalità di esecuzione delle richieste di valutazione della funzione.
InspectionSession	InspectionSession consente ai vari componenti che esaminano i dati nel processo di destinazione di archiviare i dati privati con la stessa durata. Le sessioni di ispezione vengono chiuse quando l'utente tenta di continuare il processo.
Language	Lingua usata per eseguire controlli.
Radix	Radix da usare durante la formattazione dei dati integer. I valori attualmente supportati sono '16' e '10'.
ReturnValue	[Facoltativo] Deprecato: non usare. I componenti devono invece usare la proprietà ReturnValues come elenco di tutti i valori restituiti e impostare $ReturnValue per rappresentare l'ultimo elemento del valore restituito nell'elenco.
ReturnValues	[Facoltativo] Rappresentazione non elaborata dei valori per $ReturnValue 1, $ReturnValue 2 e così via. Questa API è stata introdotta in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
RuntimeInstance	Indica quale monitoraggio runtime verrà usato per eseguire questa valutazione.
SymbolsConnection	[Facoltativo] Se non null, viene specificata una connessione a un processo di lavoro in cui vengono elaborati i simboli per l'operazione di ispezione. Questo valore sarà Null se i simboli vengono caricati nel processo IDE o se vengono caricati nel debugger remoto (DkmModule.Connection non null). Questa API è stata introdotta in Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview).
Thread	Thread esaminato.
Timeout	Questo è il timeout da usare per operazioni potenzialmente lente, ad esempio una valutazione delle funzioni. Il valore è espresso in millisecondi.

Metodi

ClrExpressionMayRequireParentheses(String)	Restituisce true se l'espressione può richiedere parentesi quando viene utilizzata come sottoespressione nel linguaggio. Vincolo location: l'API deve essere chiamata da un componente Monitor (livello < componente 100.000). Questa API è stata introdotta in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue)	Create una nuova istanza dell'oggetto DkmInspectionContext.
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority)	Create una nuova istanza dell'oggetto DkmInspectionContext. Questa API è stata introdotta in Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority, ReadOnlyCollection<DkmRawReturnValueContainer>)	Create una nuova istanza dell'oggetto DkmInspectionContext. Questa API è stata introdotta in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority, ReadOnlyCollection<DkmRawReturnValueContainer>, DkmWorkerProcessConnection)	Create una nuova istanza dell'oggetto DkmInspectionContext. Questa API è stata introdotta in Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview).
EvaluateExpression(DkmWorkList, DkmLanguageExpression, DkmStackWalkFrame, DkmCompletionRoutine<DkmEvaluateExpressionAsyncResult>)	Associare l'espressione di input e valutarla. Formattare quindi il valore risultante per la visualizzazione nel debugger. Viene usato per suggerimenti sui dati, le finestre watch, la finestra immediata e così via. Questo metodo aggiungerà un nuovo elemento di lavoro all'elenco di lavoro specificato e restituirà una volta accodato l'elemento di lavoro. L'elaborazione effettiva dell'elemento di lavoro è asincrona. Il chiamante riceverà una notifica che la richiesta viene completata tramite la routine di completamento. Vincolo location: i componenti dell'IDE possono chiamare questo metodo indipendentemente dal tipo di codice di cui viene eseguito il debug. Questo metodo è attualmente supportato anche per i componenti di monitoraggio del debug, durante il debug del codice in esecuzione in CLR; tuttavia questa funzionalità può essere rimossa in una versione futura.
EvaluateExpressionOnThreads(DkmWorkList, ReadOnlyCollection<UInt64>, DkmStackWalkFrame, DkmLanguageExpression, DkmCompletionRoutine<DkmEvaluateExpressionOnThreadsAsyncResult>)	Associare l'espressione di input e valutarla. Formattare quindi il valore risultante per la visualizzazione nel debugger. Viene usato per suggerimenti sui dati, le finestre watch, la finestra immediata e così via. Questo metodo aggiungerà un nuovo elemento di lavoro all'elenco di lavoro specificato e restituirà una volta accodato l'elemento di lavoro. L'elaborazione effettiva dell'elemento di lavoro è asincrona. Il chiamante riceverà una notifica che la richiesta viene completata tramite la routine di completamento. Vincolo location: l'API deve essere chiamata da un componente IDE (livello > componente 100.000).
EvaluateReturnValue(DkmWorkList, DkmStackWalkFrame, DkmRawReturnValue, DkmCompletionRoutine<DkmEvaluateReturnValueAsyncResult>)	Valuta e formatta un determinato DkmRawReturnValue usando esclusivamente i dati forniti. Questo metodo aggiungerà un nuovo elemento di lavoro all'elenco di lavoro specificato e restituirà una volta accodato l'elemento di lavoro. L'elaborazione effettiva dell'elemento di lavoro è asincrona. Il chiamante riceverà una notifica che la richiesta viene completata tramite la routine di completamento. Vincolo location: l'API deve essere chiamata da un componente IDE (livello > componente 100.000).
EvaluateReturnValue2(DkmWorkList, DkmStackWalkFrame, DkmRawReturnValueContainer, DkmCompletionRoutine<DkmEvaluateReturnValueAsyncResult2>)	Valuta e formatta un determinato DkmRawReturnValue usando esclusivamente i dati forniti. Questo metodo aggiungerà un nuovo elemento di lavoro all'elenco di lavoro specificato e restituirà una volta accodato l'elemento di lavoro. L'elaborazione effettiva dell'elemento di lavoro è asincrona. Il chiamante riceverà una notifica che la richiesta viene completata tramite la routine di completamento. Vincolo location: l'API deve essere chiamata da un componente IDE (livello > componente 100.000). Questa API è stata introdotta in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
GetClrArrayIndexExpression(String[])	Ottenere un'espressione di indice di matrice. Vincolo location: l'API deve essere chiamata da un componente Monitor (livello < componente 100.000). Questa API è stata introdotta in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrCastExpression(String, DkmClrType, DkmClrCustomTypeInfo, DkmClrCastExpressionOptions)	Ottiene un'espressione cast, se la sintassi valida. Vincolo location: l'API deve essere chiamata da un componente Monitor (livello < componente 100.000). Questa API è stata introdotta in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrExpressionAndFormatSpecifiers(String, ReadOnlyCollection<String>)	Suddivide la stringa nelle parti dell'identificatore di formato e dell'espressione. Vincolo location: l'API deve essere chiamata da un componente Monitor (livello < componente 100.000). Questa API è stata introdotta in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrExpressionForNull()	Ottenere l'espressione specifica del linguaggio per null (parola chiave). Vincolo location: l'API deve essere chiamata da un componente Monitor (livello < componente 100.000). Questa API è stata introdotta in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrExpressionForThis()	Ottiene l'espressione specifica del linguaggio per this/Me. Vincolo location: l'API deve essere chiamata da un componente Monitor (livello < componente 100.000). Questa API è stata introdotta in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrLocalVariableQuery(DkmClrInstructionAddress, Boolean)	Ottenere un DkmCompiledClrLocalsQuery per consentire la visualizzazione delle variabili locali. Vincolo location: l'API deve essere chiamata da un componente IDE (livello > componente 100.000). Questa API è stata introdotta in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
GetClrMemberName(String, DkmClrType, DkmClrCustomTypeInfo, String, Boolean, Boolean)	Ottiene un'espressione di accesso ai membri, se può essere rappresentata come sintassi valida. Vincolo location: l'API deve essere chiamata da un componente Monitor (livello < componente 100.000). Questa API è stata introdotta in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrNameForField(DkmClrModuleInstance, Int32)	Ottenere il nome specifico della lingua per un identificatore dai metadati. Vincolo location: l'API deve essere chiamata da un componente Monitor (livello < componente 100.000). Questa API è stata introdotta in Visual Studio 16 Update 10 (DkmApiVersion.VS16Update10).
GetClrNameForLocalVariable(DkmClrModuleInstance, DkmClrMethodId, DkmILRange, DkmClrLocalVariable)	Ottenere il nome specifico della lingua per un identificatore dai metadati. Vincolo location: l'API deve essere chiamata da un componente Monitor (livello < componente 100.000). Questa API è stata introdotta in Visual Studio 16 Update 10 (DkmApiVersion.VS16Update10).
GetClrObjectCreationExpression(DkmClrType, DkmClrCustomTypeInfo, String[])	Ottiene un'espressione di creazione dell'oggetto, se valida. Vincolo location: l'API deve essere chiamata da un componente Monitor (livello < componente 100.000). Questa API è stata introdotta in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrTypeName(DkmClrType, DkmClrCustomTypeInfo)	Ottenere il nome del tipo in un modulo valido nel linguaggio, se la sintassi valida. Questo metodo consente di costruire nomi completi validi con la possibilità di eseguire l'escape/restituire Null se non esiste una sintassi valida. Vincolo location: l'API deve essere chiamata da un componente Monitor (livello < componente 100.000). Questa API è stata introdotta in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrValidIdentifier(String)	Ottenere l'identificatore in un modulo valido nella lingua. Vincolo location: l'API deve essere chiamata da un componente Monitor (livello < componente 100.000). Questa API è stata introdotta in Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetFrameArguments(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameArgumentsAsyncResult>)	Fornisce informazioni sugli argomenti di un stack frame. Attualmente è esposto solo tramite il modello di automazione di Visual Studio (EnvDTE.StackFrame.Arguments). Questo metodo aggiungerà un nuovo elemento di lavoro all'elenco di lavoro specificato e restituirà una volta accodato l'elemento di lavoro. L'elaborazione effettiva dell'elemento di lavoro è asincrona. Il chiamante riceverà una notifica che la richiesta viene completata tramite la routine di completamento. Vincolo location: i componenti dell'IDE possono chiamare questo metodo indipendentemente dal tipo di codice di cui viene eseguito il debug. Questo metodo è attualmente supportato anche per i componenti di monitoraggio del debug, durante il debug del codice in esecuzione in CLR; tuttavia questa funzionalità può essere rimossa in una versione futura.
GetFrameLocals(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameLocalsAsyncResult>)	Ottiene un contesto di enumerazione utilizzato per ottenere le variabili locali di questo stack frame. Viene usato per calcolare la finestra variabili locali. Questo metodo aggiungerà un nuovo elemento di lavoro all'elenco di lavoro specificato e restituirà una volta accodato l'elemento di lavoro. L'elaborazione effettiva dell'elemento di lavoro è asincrona. Il chiamante riceverà una notifica che la richiesta viene completata tramite la routine di completamento. Vincolo location: i componenti dell'IDE possono chiamare questo metodo indipendentemente dal tipo di codice di cui viene eseguito il debug. Questo metodo è attualmente supportato anche per i componenti di monitoraggio del debug, durante il debug del codice in esecuzione in CLR; tuttavia questa funzionalità può essere rimossa in una versione futura.
GetFrameName(DkmWorkList, DkmStackWalkFrame, DkmVariableInfoFlags, DkmCompletionRoutine<DkmGetFrameNameAsyncResult>)	Fornisce una rappresentazione di testo per una cornice dello stack. Questa operazione viene utilizzata durante la compilazione dello stack di chiamate formattato. Questo metodo aggiungerà un nuovo elemento di lavoro all'elenco di lavoro specificato e restituirà una volta accodato l'elemento di lavoro. L'elaborazione effettiva dell'elemento di lavoro è asincrona. Il chiamante riceverà una notifica che la richiesta viene completata tramite la routine di completamento. Vincolo location: i componenti dell'IDE possono chiamare questo metodo indipendentemente dal tipo di codice in fase di debug. Questo metodo è attualmente supportato anche per i componenti di monitoraggio di debug, durante il debug del codice in esecuzione in CLR; tuttavia questa funzionalità può essere rimossa in una versione futura.
GetFrameReturnType(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameReturnTypeAsyncResult>)	Fornisce una rappresentazione di testo del tipo restituito per uno o più frame dello stack. Questa operazione è attualmente esposta solo tramite il modello di automazione VS (EnvDTE.StackFrame.ReturnType). Questo metodo aggiungerà un nuovo elemento di lavoro all'elenco di lavoro specificato e restituirà una volta aggiunto l'elemento di lavoro. L'elaborazione effettiva dell'elemento di lavoro è asincrona. Il chiamante riceverà una notifica che la richiesta viene completata tramite la routine di completamento. Vincolo percorso: l'API deve essere chiamata da un componente IDE (livello > di componente 100.000).
GetTypeName(DkmClrType, DkmClrCustomTypeInfo, ReadOnlyCollection<String>)	Ottiene la stringa del nome del tipo da visualizzare nell'interfaccia utente per il valore DkmClrType specificato. Questo metodo restituirà sempre un valore e viene usato nelle finestre di ispezione delle variabili. Vincolo percorso: l'API deve essere chiamata da un componente Monitor (livello < di componente 100.000). Questa API è stata introdotta in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
WithProperties(UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32)	Crea una copia dell'oggetto DkmInspectionContext originale con le proprietà fornite aggiornate, ad esempio EvaluationFlags o Radix. Le proprietà sono una sostituzione completa degli originali e non verranno unite alle proprietà originali. Pertanto, tutte le proprietà desiderate dall'originale DkmInspectionContext devono essere fornite a questo metodo. Questa API è stata introdotta in Visual Studio 17 Update 8 (DkmApiVersion.VS17Update8).