Procedura dettagliata: creazione e utilizzo di una libreria a collegamento dinamico (C++)

Articolo
06/10/2015

In questa procedura dettagliata viene illustrato come creare una DLL (Dynamic-Link Library) da usare con un'app scritta in C++. Una libreria è un ottimo modo per riutilizzare il codice. Anziché implementare di nuovo le stesse routine in tutte le applicazioni create, è possibile scriverle una sola volta in una libreria statica e quindi farvi riferimento dalle applicazioni che richiedono la funzionalità. L'inserimento del codice nella DLL permette di risparmiare spazio in ogni app che vi fa riferimento, ed è possibile aggiornare la DLL senza dover ricompilare tutte le app. Per altre informazioni sulle DLL, vedere DLL in Visual C++.

In questa procedura dettagliata vengono illustrate le seguenti attività:

Creazione di un progetto DLL.
Aggiunta di una classe alla DLL.
Creazione di un'app console che usa il collegamento dinamico in fase di caricamento per fare riferimento alla DLL.
Uso della funzionalità dalla classe nell'app.
Esecuzione dell'app.

In questa procedura dettagliata verrà creata una DLL che può essere chiamata solo da app che usano convenzioni di chiamata C++. Per informazioni su come creare DLL da usare con altri linguaggi, vedere Chiamata di funzioni DLL da applicazioni Visual Basic.

Prerequisiti

In questo argomento si presuppone la conoscenza delle nozioni di base del linguaggio C++.

Per creare un progetto DLL

Nella barra dei menu scegliere File, Nuovo, Progetto.
Nel riquadro sinistro della finestra di dialogo Nuovo progetto espandere Installato, Modelli, Visual C++, quindi selezionare Win32
Nel riquadro centrale, selezionare Progetto console Win32.
Specificare il nome del progetto, ad esempio MathFuncsDll, nella casella Nome. Specificare un nome per la soluzione, ad esempio DynamicLibrary, nella casella Nome soluzione. Fare clic su OK.
Nella pagina Panoramica della finestra di dialogo Creazione guidata applicazione Win32, scegliere il pulsante Avanti.
Nella pagina Impostazioni applicazione, in Tipo di applicazione selezionare DLL.
Scegliere il pulsante Fine per creare il progetto.

Per aggiungere una classe alla DLL

Per creare un file di intestazione per una nuova classe, sulla barra dei menu scegliere Progetto, Aggiungi nuovo elemento. Nella finestra di dialogo Aggiungi nuovo elemento nel riquadro sinistro in Visual C++, selezionare Codice. Nel riquadro centrale selezionare File di intestazione (.h). Specificare un nome per il file di intestazione, ad esempio MathFuncsDll.h, quindi scegliere il pulsante Aggiungi. Viene visualizzato un file di intestazione vuoto.

Aggiungere il codice seguente all'inizio del file di intestazione:

// MathFuncsDll.h

#ifdef MATHFUNCSDLL_EXPORTS
#define MATHFUNCSDLL_API __declspec(dllexport) 
#else
#define MATHFUNCSDLL_API __declspec(dllimport) 
#endif

Aggiungere una classe di base denominata MyMathFuncs per eseguire operazioni matematiche comuni quali addizione, sottrazione, moltiplicazione e divisione. Il codice dovrebbe essere analogo al seguente:
```
namespace MathFuncs
{
    // This class is exported from the MathFuncsDll.dll
    class MyMathFuncs
    {
    public: 
        // Returns a + b
        static MATHFUNCSDLL_API double Add(double a, double b); 

        // Returns a - b
        static MATHFUNCSDLL_API double Subtract(double a, double b); 

        // Returns a * b
        static MATHFUNCSDLL_API double Multiply(double a, double b); 

        // Returns a / b
        // Throws const std::invalid_argument& if b is 0
        static MATHFUNCSDLL_API double Divide(double a, double b); 
    };
}
```
Quando il simbolo MATHFUNCSDLL_EXPORTS è definito, il simbolo MATHFUNCSDLL_API imposterà il modificatore __declspec(dllexport) nelle dichiarazioni di funzione membro all'interno del codice. Questo modificatore consente alla DLL di esportare la funzione in modo che possa essere usata da altre applicazioni. Quando il simbolo MATHFUNCSDLL_EXPORTS non è definito, ad esempio quando il file di intestazione è incluso da un'applicazione, il simbolo MATHFUNCSDLL_API definisce il modificatore __declspec(dllimport) nelle dichiarazioni di funzione membro. Questo modificatore ottimizza l'importazione della funzione in un'applicazione. Per impostazione predefinita, il modello Nuovo progetto per una DLL aggiunge PROJECTNAME_EXPORTS ai simboli predefiniti per il progetto DLL. In questo esempio, il simbolo MATHFUNCSDLL_EXPORTS viene definito al momento della compilazione del progetto MathFuncsDll. Per altre informazioni, vedere dllexport, dllimport.

Nota

Se si compila il progetto DLL nella riga di comando, usare l'opzione del compilatore /D per definire il simbolo MATHFUNCSDLL_EXPORTS.
In Esplora soluzioni, nel progetto MathFuncsDll aprire il file MathFuncsDll.cpp nella cartella File di origine.

Implementare la funzionalità per MyMathFuncs nel file di origine. Il codice dovrebbe essere analogo al seguente:

// MathFuncsDll.cpp : Defines the exported functions for the DLL application. 
//

#include "stdafx.h"
#include "MathFuncsDll.h"
#include <stdexcept>

using namespace std;

namespace MathFuncs
{
    double MyMathFuncs::Add(double a, double b)
    {
        return a + b;
    }

    double MyMathFuncs::Subtract(double a, double b)
    {
        return a - b;
    }

    double MyMathFuncs::Multiply(double a, double b)
    {
        return a * b;
    }

    double MyMathFuncs::Divide(double a, double b)
    {
        if (b == 0)
        {
            throw invalid_argument("b cannot be zero!");
        }

        return a / b;
    }
}

Compilare la DLL selezionando Compila, Compila soluzione sulla barra dei menu.

Nota

Se si usa una versione Express Edition in cui non viene visualizzato il menu Compila, sulla barra dei menu scegliere Strumenti, Impostazioni, Impostazioni avanzate per abilitarlo e infine fare clic su Compila e Compila soluzione.

Nota

Se si compila il progetto nella riga di comando, usare l'opzione del compilatore /LD per specificare che il file di output deve essere una DLL.Per altre informazioni, vedere /MD, /MT, /LD (Utilizza la libreria di runtime).Usare l'opzione del compilatore /EHsc per abilitare la gestione delle eccezioni C++.Per altre informazioni, vedere /EH (Modello di gestione delle eccezioni).

Per creare un'applicazione che faccia riferimento alla DLL

Per creare un'app C++ che faccia riferimento e usi la DLL appena creata, sulla barra dei menu scegliere File, Nuovo e quindi Progetto.
Nel riquadro sinistro in Visual C++ selezionare Win32.
Nel riquadro centrale, selezionare Progetto console Win32.
Specificare il nome del progetto, ad esempio MyExecRefsDll, nella casella Nome. Nell'elenco a discesa accanto a Soluzione selezionare Aggiungi a soluzione. Verrà aggiunto un nuovo progetto alla soluzione che contiene la DLL. Fare clic su OK.
Nella pagina Panoramica della finestra di dialogo Creazione guidata applicazione Win32, scegliere il pulsante Avanti.
Nella pagina Impostazioni applicazione in Tipo di applicazione selezionare Applicazione console.
Nella pagina Impostazioni applicazione, in Opzioni aggiuntive, deselezionare la casella di controllo Intestazione precompilata.
Scegliere il pulsante Fine per creare il progetto.

Per usare la funzionalità dalla libreria di classi nell'app

Dopo aver creato un'applicazione console, verrà creato un programma vuoto. Il nome del file di origine è uguale al nome scelto in precedenza. In questo esempio il file è denominato MyExecRefsDll.cpp.
Per usare nell'app le routine matematiche create nella DLL, è necessario farvi riferimenti. A questo scopo, aprire il progetto MyExecRefsDll in Esplora soluzioni e scegliere Progetto, Riferimenti sulla barra dei menu. Nella finestra di dialogo Pagine delle proprietà espandere il nodo Proprietà comuni, selezionare Framework e riferimenti, quindi scegliere il pulsante Aggiungi nuovo riferimento. Per altre informazioni sulla finestra di dialogo Riferimenti, vedere Framework e riferimenti, Proprietà comuni, finestra di dialogo Pagine delle proprietà di <nomeprogetto>.
La finestra di dialogo Aggiungi riferimento contiene l'elenco di tutte le librerie a cui è possibile fare riferimento. Nella scheda Progetti sono elencati tutti i progetti presenti nella soluzione corrente e le eventuali librerie che essi contengono. Nella scheda Progetti selezionare la casella di controllo accanto a MathFuncsDll e quindi scegliere il pulsante OK.
Per fare riferimento ai file di intestazione della DLL, è necessario modificare il percorso delle directory incluse. A questo scopo, nella finestra di dialogo Pagine delle proprietà espandere il nodo Proprietà di configurazione, il nodo C/C++, quindi selezionare Generale. Accanto a Directory di inclusione aggiuntive specificare o cercare il percorso del file di intestazione MathFuncsDll.h. È possibile usare un percorso relativo, ad esempio ..\MathFuncsDll\, quindi scegliere il pulsante OK.

È ora possibile usare la classe MyMathFuncs nell'applicazione. Sostituire i contenuti del file MyExecRefsDll.cpp con il codice seguente:

// MyExecRefsDll.cpp 
// compile with: /EHsc /link MathFuncsDll.lib

#include <iostream>

#include "MathFuncsDll.h" 

using namespace std;

int main()
{
    double a = 7.4;
    int b = 99;

    cout << "a + b = " <<
        MathFuncs::MyMathFuncs::Add(a, b) << endl;
    cout << "a - b = " <<
        MathFuncs::MyMathFuncs::Subtract(a, b) << endl;
    cout << "a * b = " <<
        MathFuncs::MyMathFuncs::Multiply(a, b) << endl;
    cout << "a / b = " <<
        MathFuncs::MyMathFuncs::Divide(a, b) << endl;

    try
    {
        cout << "a / 0 = " <<
            MathFuncs::MyMathFuncs::Divide(a, 0) << endl; 
    }
    catch (const invalid_argument &e) 
    {
        cout << "Caught exception: " << e.what() << endl; 
    }

    return 0;
}

Compilare l'eseguibile scegliendo Compila, Compila soluzione sulla barra dei menu.

Per eseguire l'applicazione

Verificare che MyExecRefsDll sia selezionato come progetto predefinito. In Esplora soluzioni selezionare MyExecRefsDll e scegliere Progetto, Imposta come progetto di avvio sulla barra dei menu.
Per eseguire il progetto, sulla barra dei menu selezionare Debug, Avvia senza eseguire debug. Il codice sarà analogo al seguente:

a + b = 106,4 a - b = -91,6 a * b = 732,6 a / b = 0,0747475 Eccezione generata: b non può essere zero.

Vedere anche

Condividi tramite

Procedura dettagliata: creazione e utilizzo di una libreria a collegamento dinamico (C++)

Prerequisiti

Per creare un progetto DLL

Per aggiungere una classe alla DLL

Per creare un'applicazione che faccia riferimento alla DLL

Per usare la funzionalità dalla libreria di classi nell'app

Per eseguire l'applicazione

Vedere anche

Attività

Concetti

Altre risorse

Risorse aggiuntive