Partilhar via


Avaliar uma expressão de inspeção

Quando Visual Studio está pronto para exibir o valor de uma expressão de inspeção, ele chama IDebugExpression2::EvaluateSync chama IDebugParsedExpression::EvaluateSync. Isso produz um IDebugProperty2 objeto que contém o valor e o tipo da expressão.

Nesta implementação de IDebugParsedExpression::EvaluateSync, a expressão é analisada e avaliada ao mesmo tempo. Essa implementação realiza as seguintes tarefas:

  1. Analisa e avalia a expressão para produzir um objeto genérico que contém o valor e o seu tipo. No C#, isso é representado como um object enquanto em C++ é representado como um VARIANT.

  2. Instancia uma classe (chamado CValueProperty neste exemplo) que implementa o IDebugProperty2 interface e o armazena na classe o valor a ser retornado.

  3. Retorna o IDebugProperty2 interface a partir de CValueProperty objeto.

Código gerenciado

Esta é uma implementação da IDebugParsedExpression::EvaluateSync em código gerenciado. O método auxiliar Tokenize analisa a expressão em uma árvore de análise. A função auxiliar EvalToken converte o símbolo em um valor. A função auxiliar FindTerm recursivamente percorre a árvore de análise, chamando EvalToken para cada nó que representa um valor e a aplicação de todas as operações (adição ou subtração) na expressão.

namespace EEMC
{
    public class CParsedExpression : IDebugParsedExpression
    {
        public HRESULT EvaluateSync(
            uint evalFlags,
            uint timeout,
            IDebugSymbolProvider provider,
            IDebugAddress address,
            IDebugBinder binder,
            string resultType,
            out IDebugProperty2 result)
        {
            HRESULT retval = COM.S_OK;
            this.evalFlags = evalFlags;
            this.timeout = timeout;
            this.provider = provider;
            this.address = address;
            this.binder = binder;
            this.resultType = resultType;

            try
            {
                IDebugField field = null;
                // Tokenize, then parse.
                tokens = Tokenize(expression);
                result = new CValueProperty(
                             expression,
                             (int) FindTerm(EvalToken(tokens[0], out field),1),
                             field,
                             binder);
            }
            catch (ParseException)
            {
                result = new CValueProperty(expression, "Huh?");
                retval = COM.E_INVALIDARG;
            }
            return retval;
        }
    }
}

Código não gerenciado

Esta é uma implementação da IDebugParsedExpression::EvaluateSync em código não gerenciado. A função auxiliar Evaluate analisa e avalia a expressão, retornando um VARIANT que contém o valor resultante. A função auxiliar VariantValueToProperty pacotes de VARIANT em um CValueProperty objeto.

[C++]
STDMETHODIMP CParsedExpression::EvaluateSync( 
    in  DWORD                 evalFlags,
    in  DWORD                 dwTimeout,
    in  IDebugSymbolProvider* pprovider,
    in  IDebugAddress*        paddress,
    in  IDebugBinder*         pbinder,
    in  BSTR                  bstrResultType,
    out IDebugProperty2**     ppproperty )
{
    // dwTimeout parameter is ignored in this implementation.
    if (pprovider == NULL)
        return E_INVALIDARG;

    if (paddress == NULL)
        return E_INVALIDARG;

    if (pbinder == NULL)
        return E_INVALIDARG;

    if (ppproperty == NULL)
        return E_INVALIDARG;
    else
        *ppproperty = 0;

    HRESULT hr;
    VARIANT value;
    BSTR    bstrErrorMessage = NULL;
    hr = ::Evaluate( pprovider,
                     paddress,
                     pbinder,
                     m_expr,
                     &bstrErrorMessage,
                     &value );
    if (hr != S_OK)
    {
        if (bstrErrorMessage == NULL)
            return hr;

        //we can display better messages ourselves.
        HRESULT hrLocal = S_OK;
        VARIANT varType;
        VARIANT varErrorMessage;

        VariantInit( &varType );
        VariantInit( &varErrorMessage );
        varErrorMessage.vt      = VT_BSTR;
        varErrorMessage.bstrVal = bstrErrorMessage;

        CValueProperty* valueProperty = new CValueProperty();
        if (valueProperty != NULL)
        {
            hrLocal = valueProperty->Init(m_expr, varType, varErrorMessage);
            if (SUCCEEDED(hrLocal)) 
            {
                hrLocal = valueProperty->QueryInterface( IID_IDebugProperty2,
                        reinterpret_cast<void**>(ppproperty) );
            }
        }

        VariantClear(&varType);
        VariantClear(&varErrorMessage); //frees BSTR
        if (!valueProperty)
            return hr;
        valueProperty->Release();
        if (FAILED(hrLocal))
            return hr;
    }
    else
    {
        if (bstrErrorMessage != NULL)
            SysFreeString(bstrErrorMessage);

        hr = VariantValueToProperty( pprovider,
                                     paddress,
                                     pbinder,
                                     m_radix,
                                     m_expr,
                                     value,
                                     ppproperty );
        VariantClear(&value);
        if (FAILED(hr))
            return hr;
    }

    return S_OK;
}

Consulte também

Conceitos

Avaliar uma expressão de janela de inspeção

Exemplo de implementação de avaliação de expressão