Condividi tramite

Registrare un analizzatore di espressioni

Importante

In Visual Studio 2015 questo modo di implementare gli analizzatori di espressioni è deprecato. Per informazioni sull'implementazione degli analizzatori di espressioni CLR, vedere l'esempio degli analizzatori di espressioni CLR e dell'analizzatore di espressioni gestite.

L'analizzatore di espressioni (EE) deve registrarsi come class factory sia con l'ambiente COM di Windows che con Visual Studio. Un EE viene configurato come DLL in modo che venga inserito nello spazio indirizzi del motore di debug (DE) o nello spazio indirizzi di Visual Studio, a seconda dell'entità di cui crea un'istanza di EE.

Analizzatore di espressioni di codice gestito

Un EE del codice gestito viene implementato come libreria di classi, ovvero una DLL che si registra con l'ambiente COM, in genere avviata da una chiamata al programma VSIP, regpkg.exe. Il processo effettivo di scrittura delle chiavi del Registro di sistema per l'ambiente COM viene gestito automaticamente.

Un metodo della classe main è contrassegnato con ComRegisterFunctionAttribute, che indica che il metodo deve essere chiamato quando la DLL viene registrata con COM. Questo metodo di registrazione, spesso chiamato RegisterClass, esegue l'attività di registrazione della DLL con Visual Studio. Un oggetto corrispondente UnregisterClass (contrassegnato con ), ComUnregisterFunctionAttributeannulla gli effetti di RegisterClass quando la DLL viene disinstallata. Le stesse voci del Registro di sistema vengono create come per un EE scritto in codice non gestito; l'unica differenza è che non esiste una funzione di supporto, come ad esempio SetEEMetric, che faccia il lavoro per te. Di seguito è riportato un esempio del processo di registrazione e annullamento della registrazione.

Example

La funzione seguente illustra come un EE di codice gestito registra e annulla la registrazione con Visual Studio.

namespace EEMC
{
    [GuidAttribute("462D4A3D-B257-4AEE-97CD-5918C7531757")]
    public class EEMCClass : IDebugExpressionEvaluator
    {
        #region Register and unregister.
        private static Guid guidMycLang = new Guid("462D4A3E-B257-4AEE-97CD-5918C7531757");
        private static string languageName = "MyC";
        private static string eeName = "MyC Expression Evaluator";

        private static Guid guidMicrosoftVendor = new Guid("994B45C4-E6E9-11D2-903F-00C04FA302A1");
        private static Guid guidCOMPlusOnlyEng = new Guid("449EC4CC-30D2-4032-9256-EE18EB41B62B");
        private static Guid guidCOMPlusNativeEng = new Guid("92EF0900-2251-11D2-B72E-0000F87572EF");

        /// <summary>
        /// Register the expression evaluator.
        /// Set "project properties/configuration properties/build/register for COM interop" to true.
        /// </summary>
         [ComRegisterFunctionAttribute]
        public static void RegisterClass(Type t)
        {
            // Get Visual Studio version (set by regpkg.exe)
            string hive = Environment.GetEnvironmentVariable("EnvSdk_RegKey");
            string s = @"SOFTWARE\Microsoft\VisualStudio\"
                        + hive
                        + @"\AD7Metrics\ExpressionEvaluator";

            RegistryKey rk = Registry.LocalMachine.CreateSubKey(s);
            if (rk == null)  return;

            rk = rk.CreateSubKey(guidMycLang.ToString("B"));
            rk = rk.CreateSubKey(guidMicrosoftVendor.ToString("B"));
            rk.SetValue("CLSID", t.GUID.ToString("B"));
            rk.SetValue("Language", languageName);
            rk.SetValue("Name", eeName);

            rk = rk.CreateSubKey("Engine");
            rk.SetValue("0", guidCOMPlusOnlyEng.ToString("B"));
            rk.SetValue("1", guidCOMPlusNativeEng.ToString("B"));
        }
        /// <summary>
        /// Unregister the expression evaluator.
        /// </summary>
         [ComUnregisterFunctionAttribute]
        public static void UnregisterClass(Type t)
        {
            // Get Visual Studio version (set by regpkg.exe)
            string hive = Environment.GetEnvironmentVariable("EnvSdk_RegKey");
            string s = @"SOFTWARE\Microsoft\VisualStudio\"
                        + hive
                        + @"\AD7Metrics\ExpressionEvaluator\"
                        + guidMycLang.ToString("B");
            RegistryKey key = Registry.LocalMachine.OpenSubKey(s);
            if (key != null)
            {
                key.Close();
                Registry.LocalMachine.DeleteSubKeyTree(s);
            }
        }
    }
}

Analizzatore di espressioni di codice non gestite

La DLL EE implementa la DllRegisterServer funzione per registrarsi con l'ambiente COM e Visual Studio.

Annotazioni

È possibile trovare il codice del Registro di sistema di esempio di codice MyCEE nel file dllentry.cpp, che si trova nell'installazione di VSIP in EnVSDK\MyCPkgs\MyCEE.

Processo del server DLL

Quando si registra EE, il server DLL:

  1. Registra la class factory CLSID in base alle normali convenzioni COM.

  2. Chiama la funzione di supporto SetEEMetric per registrare con Visual Studio le metriche EE illustrate nella tabella seguente. La funzione SetEEMetric e le metriche specificate di seguito fanno parte della libreria dbgmetric.lib . Per informazioni dettagliate, vedere Helper SDK per il debug .

    Metrica Description
    metricCLSID CLSID della classe fabbrica EE
    metricName Nome dell'EE come stringa visualizzabile
    metricLanguage Nome della lingua che l'EE è progettato per valutare
    metricEngine GUIDs dei motori di debug (DE) che funzionano con questo EE

    Annotazioni

    metricLanguage``GUID Identifica la lingua in base al nome, ma è l'argomento guidLang a SetEEMetric che seleziona la lingua. Quando il compilatore genera il file di informazioni di debug, deve scrivere l'oggetto appropriato guidLang in modo che DE conosca quale EE usare. De richiede in genere al provider di simboli questo linguaggio , che viene archiviato GUIDnel file di informazioni di debug.

  3. Esegue la registrazione con Visual Studio creando chiavi in HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\X.Y, dove X.Y è la versione di Visual Studio con cui eseguire la registrazione.

Example

La funzione seguente mostra come un codice non gestito (C++) EE registra e annulla la registrazione con Visual Studio.

/*---------------------------------------------------------
  Registration
-----------------------------------------------------------*/
#ifndef LREGKEY_VISUALSTUDIOROOT
    #define LREGKEY_VISUALSTUDIOROOT L"Software\\Microsoft\\VisualStudio\\8.0"
#endif

static HRESULT RegisterMetric( bool registerIt )
{
    // check where we should register
    const ULONG cchBuffer = _MAX_PATH;
    WCHAR wszRegistrationRoot[cchBuffer];
    DWORD cchFreeBuffer = cchBuffer - 1;
    wcscpy(wszRegistrationRoot, LREGKEY_VISUALSTUDIOROOT_NOVERSION);
    wcscat(wszRegistrationRoot, L"\\");

    // this is Environment SDK specific
    // we check for  EnvSdk_RegKey environment variable to
    // determine where to register
    DWORD cchDefRegRoot = lstrlenW(LREGKEY_VISUALSTUDIOROOT_NOVERSION) + 1;
    cchFreeBuffer = cchFreeBuffer - cchDefRegRoot;
    DWORD cchEnvVarRead = GetEnvironmentVariableW(
        /* LPCTSTR */ L"EnvSdk_RegKey", // environment variable name
        /* LPTSTR  */ &wszRegistrationRoot[cchDefRegRoot],// buffer for variable value
        /* DWORD   */ cchFreeBuffer);// size of buffer
    if (cchEnvVarRead >= cchFreeBuffer)
        return E_UNEXPECTED;
    // If the environment variable does not exist then we must use
    // LREGKEY_VISUALSTUDIOROOT which has the version number.
    if (0 == cchEnvVarRead)
        wcscpy(wszRegistrationRoot, LREGKEY_VISUALSTUDIOROOT);

    if (registerIt)
    {
        SetEEMetric(guidMycLang,
                    guidMicrosoftVendor,
                    metricCLSID,
                    CLSID_MycEE,
                    wszRegistrationRoot );
        SetEEMetric(guidMycLang,
                    guidMicrosoftVendor,
                    metricName,
                    GetString(IDS_INFO_MYCDESCRIPTION),
                    wszRegistrationRoot );
        SetEEMetric(guidMycLang,
                    guidMicrosoftVendor,
                    metricLanguage, L"MyC",
                    wszRegistrationRoot);

        GUID engineGuids[2];
        engineGuids[0] = guidCOMPlusOnlyEng;
        engineGuids[1] = guidCOMPlusNativeEng;
        SetEEMetric(guidMycLang,
                    guidMicrosoftVendor,
                    metricEngine,
                    engineGuids,
                    2,
                    wszRegistrationRoot);
    }
    else
    {
        RemoveEEMetric( guidMycLang,
                        guidMicrosoftVendor,
                        metricCLSID,
                        wszRegistrationRoot);
        RemoveEEMetric( guidMycLang,
                        guidMicrosoftVendor,
                        metricName,
                        wszRegistrationRoot );
        RemoveEEMetric( guidMycLang,
                        guidMicrosoftVendor,
                        metricLanguage,
                        wszRegistrationRoot );
        RemoveEEMetric( guidMycLang,
                        guidMicrosoftVendor,
                        metricEngine,
                        wszRegistrationRoot );
    }

    return S_OK;
}

Contenuti correlati

  • Last updated on