Udostępnij za pośrednictwem

ICorDebugEval, interfejs

  • Artykuł

Dostarcza metody umożliwiające debugerowi wykonywanie kodu w kontekście debugowanego kodu.

Metody

Metoda Opis
Abort — Metoda Przerywa obliczanie, które jest obecnie wykonywane przez ten ICorDebugEval obiekt.
CallFunction, metoda Konfiguruje wywołanie określonej funkcji. (Przestarzałe w .NET Framework w wersji 2.0; zamiast tego użyj funkcji ICorDebugEval2::CallParameterizedFunction).
CreateValue, metoda Pobiera wskaźnik interfejsu do obiektu "ICorDebugValue" określonego typu z początkową wartością zero lub null. (Przestarzałe w .NET Framework 2.0; zamiast tego użyj elementu ICorDebugEval2::CreateValueForType).
GetResult, metoda Pobiera wskaźnik interfejsu do elementu ICorDebugValue zawierającego wyniki oceny.
GetThread, metoda Pobiera wskaźnik interfejsu do elementu "ICorDebugThread", w którym ta ocena jest wykonywana lub wykonywana.
IsActive — Metoda Pobiera wartość wskazującą, czy ten ICorDebugEval obiekt jest obecnie wykonywany.
NewArray, metoda Przydziela nową tablicę określonego typu elementu i wymiarów. (Przestarzałe w .NET Framework 2.0; zamiast tego użyj elementu ICorDebugEval2::NewParameterizedArray).
NewObject, metoda Przydziela nowe wystąpienie obiektu i wywołuje określoną metodę konstruktora. (Przestarzałe w .NET Framework 2.0; zamiast tego użyj elementu ICorDebugEval2::NewParameterizedObject).
NewObjectNoConstructor, metoda Przydziela nowe wystąpienie obiektu określonego typu bez próby wywołania metody konstruktora. (Przestarzałe w .NET Framework 2.0; zamiast tego użyj elementu ICorDebugEval2::NewParameterizedObjectNoConstructor).
NewString, metoda Przydziela nowy obiekt ciągu z określoną zawartością.

Uwagi

ICorDebugEval Obiekt jest tworzony w kontekście określonego wątku używanego do przeprowadzania ocen. Wszystkie obiekty i typy używane w danej ocenie muszą znajdować się w tej samej domenie aplikacji. Ta domena aplikacji nie musi być taka sama jak bieżąca domena aplikacji wątku. Oceny można zagnieżdżać.

Operacje oceny nie zostaną ukończone, dopóki debuger nie wywoła wywołania wywołania ICorDebugController::Continue, a następnie otrzyma wywołanie zwrotne ICorDebugManagedCallback::EvalComplete . Jeśli musisz użyć funkcji oceny bez zezwalania innym wątkom na uruchamianie, wstrzymywanie wątków przy użyciu elementu ICorDebugController::SetAllThreadsDebugState lub ICorDebugController::Stop przed wywołaniem elementu ICorDebugController::Continue.

Ponieważ kod użytkownika jest uruchamiany, gdy ocena jest w toku, mogą wystąpić wszystkie zdarzenia debugowania, w tym obciążenia klas i punkty przerwania. Debuger otrzyma wywołania zwrotne, jak zwykle, dla tych zdarzeń. Stan oceny będzie postrzegany jako część kontroli stanu normalnego programu. Łańcuch stosu będzie łańcuchem CHAIN_FUNC_EVAL (zobacz wyliczenie " CorDebugStepReason" i metodę ICorDebugChain::GetReason ). Pełny interfejs API debugera będzie nadal działać normalnie.

Jeśli pojawi się sytuacja zakleszczenia lub nieskończona pętla, kod użytkownika może nigdy nie zostać ukończony. W takim przypadku należy wywołać metodę ICorDebugEval::Abort przed wznowieniem programu.

Uwaga

Ten interfejs nie obsługuje wywoływanego zdalnie, między maszynami lub między procesami.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: CorDebug.idl, CorDebug.h

Biblioteki: CorGuids.lib

wersje .NET Framework: dostępne od wersji 1.0

Zobacz też