ICorDebugEval (Interfaz)

Artículo
08/10/2011

Proporciona métodos que permiten al depurador ejecutar código en el contexto del código que se está depurando.

Métodos

Método	Descripción
ICorDebugEval::Abort (Método)	Anula el cálculo que está realizando actualmente este objeto ICorDebugEval.
ICorDebugEval::CallFunction (Método)	Configura una llamada a la función especificada. (Obsoleto en .NET Framework 2.0; utilice ICorDebugEval2::CallParameterizedFunction en su lugar).
ICorDebugEval::CreateValue (Método)	Obtiene un puntero de interfaz a un objeto ICorDebugValue (Interfaz) del tipo especificado, con un valor inicial de cero o null. (Obsoleto en .NET Framework 2.0; utilice ICorDebugEval2::CreateValueForType en su lugar).
ICorDebugEval::GetResult (Método)	Obtiene un puntero de interfaz a una instancia de ICorDebugValue que contiene los resultados de la evaluación.
ICorDebugEval::GetThread (Método)	Obtiene un puntero de interfaz a la instancia de ICorDebugThread en la que se está ejecutando o se va a ejecutar esta evaluación.
ICorDebugEval::IsActive (Método)	Obtiene un valor que indica si este objeto ICorDebugEval se está ejecutando actualmente.
ICorDebugEval::NewArray (Método)	Asigna una nueva matriz del tipo de elemento y dimensiones especificados. (Obsoleto en .NET Framework 2.0; utilice ICorDebugEval2::NewParameterizedArray en su lugar).
ICorDebugEval::NewObject (Método)	Asigna una nueva instancia de objeto y llama al método de constructor especificado. (Obsoleto en .NET Framework 2.0; utilice ICorDebugEval2::NewParameterizedObject en su lugar).
ICorDebugEval::NewObjectNoConstructor (Método)	Asigna una nueva instancia de objeto del tipo especificado, pero no intenta llamar a un método de constructor. (Obsoleto en .NET Framework 2.0; utilice ICorDebugEval2::NewParameterizedObjectNoConstructor en su lugar).
ICorDebugEval::NewString (Método)	Asigna un nuevo objeto de cadena con el contenido especificado.

Comentarios

Se crea un objeto ICorDebugEval en el contexto de un subproceso específico que se utiliza para realizar las evaluaciones. Todos los objetos y tipos utilizados en una evaluación determinada deben residir dentro del mismo dominio de aplicación. Ese dominio de aplicación no tiene que ser el dominio de aplicación actual del subproceso. Las evaluaciones se pueden anidar.

Las operaciones de evaluación no se completan hasta que el depurador llama a ICorDebugController::Continue y recibe después una devolución de llamada de ICorDebugManagedCallback::EvalComplete. Si necesita utilizar la funcionalidad de evaluación sin permitir la ejecución de otros subprocesos, suspenda los subprocesos utilizando ICorDebugController::SetAllThreadsDebugState o ICorDebugController::Stop antes de llamar a ICorDebugController::Continue.

Dado que el código de usuario se está ejecutando cuando la evaluación está en curso, pueden producirse eventos de depuración, incluso cargas de clase y puntos de interrupción. El depurador recibirá las devoluciones de llamada, como es habitual, para estos eventos. El estado de la evaluación se considerará una parte de la inspección del estado normal del programa. La cadena de pila será una cadena CHAIN_FUNC_EVAL (vea la enumeración CorDebugStepReason y el método ICorDebugChain::GetReason). La API del depurador continuará funcionando con normalidad.

Si se producen interbloqueos o bucles infinitos, es posible que el código de usuario nunca finalice. En este caso, debe llamar a ICorDebugEval::Abort antes de reanudar el programa.