DkmInspectionContext Klasa

Definicja

Przestrzeń nazw:

Microsoft.VisualStudio.Debugger.Evaluation

Zestaw:

Microsoft.VisualStudio.Debugger.Engine.dll

Pakiet:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Opcje i kontekst docelowy do użycia podczas wykonywania operacji inspekcji.

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

Dziedziczenie

Object

DkmInspectionContext

Atrybuty

GuidAttribute

Właściwości

AdditionalVisualizationData	[Opcjonalnie] Określa opcjonalną listę pełnych ścieżek do użycia w plikach wizualizacji, oprócz plików domyślnych z katalogu profilów użytkowników i katalogu instalacyjnego programu Visual Studio. Pierwszeństwo między wizualizatorami powodującym konflikt w tych ścieżkach jest rozwiązywane względem standardowych ścieżek zgodnie z informacjami określonymi w temacie "AdditionalVisualizationDataPriority". Ten interfejs API został wprowadzony w programie Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
AdditionalVisualizationDataPriority	Jeśli określono wartość AdditionalVisualizationData, określa priorytet takich danych względem domyślnych lokalizacji wyszukiwania. Ten interfejs API został wprowadzony w programie Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
EvaluationFlags	Flagi, które wpływają na sposób analizowania, kompilowania lub wyświetlania wyrażenia wejściowego.
FuncEvalFlags	Flagi wpływające na sposób wykonywania żądań oceny funkcji.
InspectionSession	Funkcja InspectionSession umożliwia różnym składnikom, które badają dane w procesie docelowym w celu przechowywania danych prywatnych z tym samym okresem istnienia. Sesje inspekcji są zamykane, gdy użytkownik próbuje kontynuować proces.
Language	Język używany do przeprowadzania inspekcji.
Radix	Radix do użycia podczas formatowania danych całkowitych. Obecnie obsługiwane wartości to "16" i "10".
ReturnValue	[Opcjonalnie] Przestarzałe — nie używaj. Zamiast tego składniki powinny używać właściwości ReturnValues jako listy wszystkich zwracanych wartości i ustawić $ReturnValue, aby reprezentować ostatni element wartości zwracanej na liście.
ReturnValues	[Opcjonalnie] Nieprzetworzona reprezentacja wartości dla $ReturnValue 1, $ReturnValue 2 itp. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
RuntimeInstance	Wskazuje, który monitor środowiska uruchomieniowego będzie używany do przeprowadzenia tej oceny.
SymbolsConnection	[Opcjonalnie] Jeśli nie ma wartości null, określa to połączenie z procesem roboczym, w którym są przetwarzane symbole tej operacji inspekcji. Będzie to mieć wartość null, jeśli symbole są ładowane w procesie IDE lub jeśli są ładowane do zdalnego debugera (DkmModule.Connection jest inne niż null). Ten interfejs API został wprowadzony w programie Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview).
Thread	Badany wątek.
Timeout	Jest to limit czasu, który ma być używany w przypadku potencjalnie powolnych operacji, takich jak ocena funkcji. Ta wartość jest wyrażona w milisekundach.

Metody

ClrExpressionMayRequireParentheses(String)	Zwraca wartość true, jeśli wyrażenie może wymagać nawiasów w przypadku użycia jako wyrażenie podrzędne w języku. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue)	Twórca nowe wystąpienie obiektu DkmInspectionContext.
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority)	Twórca nowe wystąpienie obiektu DkmInspectionContext. Ten interfejs API został wprowadzony w programie Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority, ReadOnlyCollection<DkmRawReturnValueContainer>)	Twórca nowe wystąpienie obiektu DkmInspectionContext. Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority, ReadOnlyCollection<DkmRawReturnValueContainer>, DkmWorkerProcessConnection)	Twórca nowe wystąpienie obiektu DkmInspectionContext. Ten interfejs API został wprowadzony w programie Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview).
EvaluateExpression(DkmWorkList, DkmLanguageExpression, DkmStackWalkFrame, DkmCompletionRoutine<DkmEvaluateExpressionAsyncResult>)	Powiąż wyrażenie wejściowe i oceń je. Następnie sformatuj wynikowa wartość do wyświetlenia w debugerze. Jest to używane w przypadku porad dotyczących danych, okien watch, okna natychmiastowego itp. Ta metoda dołączy nowy element roboczy do określonej listy roboczej i powróci po dołączeniu elementu roboczego. Rzeczywiste przetwarzanie elementu roboczego jest asynchroniczne. Obiekt wywołujący zostanie powiadomiony, że żądanie zostało ukończone przez procedurę uzupełniania. Ograniczenie lokalizacji: składniki IDE mogą wywoływać tę metodę niezależnie od typu kodu, który jest debugowany. Ta metoda jest również obecnie obsługiwana w przypadku składników monitora debugowania podczas debugowania kodu uruchomionego w środowisku CLR; jednak ta funkcja może zostać usunięta w przyszłej wersji.
EvaluateExpressionOnThreads(DkmWorkList, ReadOnlyCollection<UInt64>, DkmStackWalkFrame, DkmLanguageExpression, DkmCompletionRoutine<DkmEvaluateExpressionOnThreadsAsyncResult>)	Powiąż wyrażenie wejściowe i oceń je. Następnie sformatuj wynikowa wartość do wyświetlenia w debugerze. Jest to używane w przypadku porad dotyczących danych, okien watch, okna natychmiastowego itp. Ta metoda dołączy nowy element roboczy do określonej listy roboczej i powróci po dołączeniu elementu roboczego. Rzeczywiste przetwarzanie elementu roboczego jest asynchroniczne. Obiekt wywołujący zostanie powiadomiony, że żądanie zostało ukończone przez procedurę uzupełniania. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000).
EvaluateReturnValue(DkmWorkList, DkmStackWalkFrame, DkmRawReturnValue, DkmCompletionRoutine<DkmEvaluateReturnValueAsyncResult>)	Ocenia i formatuje daną wartość DkmRawReturnValue wyłącznie przy użyciu podanych danych. Ta metoda dołączy nowy element roboczy do określonej listy roboczej i powróci po dołączeniu elementu roboczego. Rzeczywiste przetwarzanie elementu roboczego jest asynchroniczne. Obiekt wywołujący zostanie powiadomiony, że żądanie zostało ukończone przez procedurę uzupełniania. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000).
EvaluateReturnValue2(DkmWorkList, DkmStackWalkFrame, DkmRawReturnValueContainer, DkmCompletionRoutine<DkmEvaluateReturnValueAsyncResult2>)	Ocenia i formatuje daną wartość DkmRawReturnValue wyłącznie przy użyciu podanych danych. Ta metoda dołączy nowy element roboczy do określonej listy roboczej i powróci po dołączeniu elementu roboczego. Rzeczywiste przetwarzanie elementu roboczego jest asynchroniczne. Obiekt wywołujący zostanie powiadomiony, że żądanie zostało ukończone przez procedurę uzupełniania. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
GetClrArrayIndexExpression(String[])	Pobierz wyrażenie indeksu tablicy. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrCastExpression(String, DkmClrType, DkmClrCustomTypeInfo, DkmClrCastExpressionOptions)	Pobierz wyrażenie rzutu, jeśli jest prawidłowa składnia. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrExpressionAndFormatSpecifiers(String, ReadOnlyCollection<String>)	Dzieli ciąg na części specyfikatora wyrażenia i formatu. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrExpressionForNull()	Pobierz wyrażenie specyficzne dla języka dla wartości null (słowa kluczowego). Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrExpressionForThis()	Pobierz wyrażenie specyficzne dla języka dla tego/mnie. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrLocalVariableQuery(DkmClrInstructionAddress, Boolean)	Pobierz plik DkmCompiledClrLocalsQuery, aby umożliwić wyświetlanie zmiennych lokalnych. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
GetClrMemberName(String, DkmClrType, DkmClrCustomTypeInfo, String, Boolean, Boolean)	Pobierz wyrażenie dostępu do elementu członkowskiego, jeśli może być reprezentowane jako prawidłowa składnia. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrNameForField(DkmClrModuleInstance, Int32)	Pobierz nazwę specyficzną dla języka dla identyfikatora z metadanych. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 16 Update 10 (DkmApiVersion.VS16Update10).
GetClrNameForLocalVariable(DkmClrModuleInstance, DkmClrMethodId, DkmILRange, DkmClrLocalVariable)	Pobierz nazwę specyficzną dla języka dla identyfikatora z metadanych. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 16 Update 10 (DkmApiVersion.VS16Update10).
GetClrObjectCreationExpression(DkmClrType, DkmClrCustomTypeInfo, String[])	Pobierz wyrażenie tworzenia obiektu, jeśli jest prawidłowa składnia. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrTypeName(DkmClrType, DkmClrCustomTypeInfo)	Pobierz nazwę typu w formularzu prawidłowym w języku, jeśli jest prawidłowa składnia. Ta metoda służy do konstruowania prawidłowych pełnych nazw z możliwością ucieczki/zwracania wartości null, jeśli nie ma prawidłowej składni. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetClrValidIdentifier(String)	Pobierz identyfikator w formularzu prawidłowym w języku. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetFrameArguments(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameArgumentsAsyncResult>)	Zawiera informacje na temat argumentów ramki stosu. Jest to obecnie widoczne tylko za pośrednictwem modelu automatyzacji programu VS (EnvDTE.StackFrame.Arguments). Ta metoda dołączy nowy element roboczy do określonej listy roboczej i powróci po dołączeniu elementu roboczego. Rzeczywiste przetwarzanie elementu roboczego jest asynchroniczne. Obiekt wywołujący zostanie powiadomiony, że żądanie zostało ukończone przez procedurę uzupełniania. Ograniczenie lokalizacji: składniki IDE mogą wywoływać tę metodę niezależnie od typu kodu, który jest debugowany. Ta metoda jest również obecnie obsługiwana w przypadku składników monitora debugowania podczas debugowania kodu uruchomionego w środowisku CLR; jednak ta funkcja może zostać usunięta w przyszłej wersji.
GetFrameLocals(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameLocalsAsyncResult>)	Pobiera kontekst wyliczenia używany do uzyskiwania zmiennych lokalnych tej ramki stosu. Jest to używane w przetwarzaniu okna ustawień lokalnych. Ta metoda dołączy nowy element roboczy do określonej listy roboczej i powróci po dołączeniu elementu roboczego. Rzeczywiste przetwarzanie elementu roboczego jest asynchroniczne. Obiekt wywołujący zostanie powiadomiony, że żądanie zostało ukończone przez procedurę uzupełniania. Ograniczenie lokalizacji: składniki IDE mogą wywoływać tę metodę niezależnie od typu kodu, który jest debugowany. Ta metoda jest również obecnie obsługiwana w przypadku składników monitora debugowania podczas debugowania kodu uruchomionego w środowisku CLR; jednak ta funkcja może zostać usunięta w przyszłej wersji.
GetFrameName(DkmWorkList, DkmStackWalkFrame, DkmVariableInfoFlags, DkmCompletionRoutine<DkmGetFrameNameAsyncResult>)	Zawiera reprezentację tekstową dla ramki stosu. Jest to używane podczas tworzenia sformatowanego stosu wywołań. Ta metoda dołączy nowy element roboczy do określonej listy roboczej i powróci po dołączeniu elementu roboczego. Rzeczywiste przetwarzanie elementu roboczego jest asynchroniczne. Obiekt wywołujący zostanie powiadomiony, że żądanie zostało ukończone przez procedurę ukończenia. Ograniczenie lokalizacji: składniki IDE mogą wywoływać tę metodę niezależnie od typu kodu, który jest debugowany. Ta metoda jest również obecnie obsługiwana w przypadku składników monitora debugowania podczas debugowania kodu uruchomionego w środowisku CLR; jednak ta funkcja może zostać usunięta w przyszłej wersji.
GetFrameReturnType(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameReturnTypeAsyncResult>)	Zawiera tekstową reprezentację typu zwracanego dla co najmniej jednej ramki stosu. Jest to obecnie widoczne tylko za pośrednictwem modelu automatyzacji programu VS (EnvDTE.StackFrame.ReturnType). Ta metoda dołączy nowy element roboczy do określonej listy roboczej i powróci po dołączeniu elementu roboczego. Rzeczywiste przetwarzanie elementu roboczego jest asynchroniczne. Obiekt wywołujący zostanie powiadomiony, że żądanie zostało ukończone przez procedurę ukończenia. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika IDE (poziom > składnika 100 000).
GetTypeName(DkmClrType, DkmClrCustomTypeInfo, ReadOnlyCollection<String>)	Pobiera ciąg nazwy typu do wyświetlenia w interfejsie użytkownika dla danego parametru DkmClrType. Ta metoda zawsze zwraca wartość i jest używana w oknach inspekcji zmiennych. Ograniczenie lokalizacji: interfejs API musi być wywoływany ze składnika Monitor (poziom < składnika 100 000). Ten interfejs API został wprowadzony w programie Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
WithProperties(UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32)	Tworzy kopię oryginalnego obiektu DkmInspectionContext ze zaktualizowanymi podanymi właściwościami, takimi jak EvaluationFlags lub Radix. Właściwości są pełnym zastąpieniem oryginałów i nie zostaną scalone z oryginalnymi właściwościami. W związku z tym do tej metody należy podać wszelkie żądane właściwości z oryginalnego obiektu DkmInspectionContext. Ten interfejs API został wprowadzony w programie Visual Studio 17 Update 8 (DkmApiVersion.VS17Update8).