Je eerste AutoCAD C# add-in bouwen: stap voor stap

Wat is een AutoCAD add-in?

Een AutoCAD add-in is een .NET DLL die AutoCAD laadt bij het opstarten of op aanvraag. Daarmee kun je eigen commando's toevoegen, de interface aanpassen of taken automatiseren die anders handmatig zouden gaan.

In deze tutorial gebruiken we C# en Visual Studio om een eenvoudige add-in te bouwen die een eigen commando toevoegt aan AutoCAD.

Wat heb je nodig?

• Visual Studio 2022 (Community is gratis)
• AutoCAD 2025 of later (inclusief de SDK, te downloaden via de Autodesk Developer Network)
• Basiskennis C# (variabelen, classes, methods)

Stap 1: Nieuw Class Library project aanmaken

Open Visual Studio en maak een nieuw project aan:

1. Kies Class Library (.NET Framework) — kies .NET Framework 4.8 voor AutoCAD 2024 en ouder, of .NET 8 voor AutoCAD 2025+.
2. Geef het project een naam, bijvoorbeeld MijnAutoCADAddin.
3. Klik op Maken.

Let op: Kies géén Console App of WinForms. Een add-in is altijd een Class Library (DLL), nooit een uitvoerbaar bestand.

Stap 2: AutoCAD references toevoegen

Je project heeft de AutoCAD API-bibliotheken nodig. Die zitten in de AutoCAD installatiemap, standaard onder:

C:\Program Files\Autodesk\AutoCAD 2025\

Voeg de volgende DLL's toe als referentie (Project ? Add Reference ? Browse):

• AcMgd.dll — managed API voor AutoCAD-applicaties
• AcCoreMgd.dll — core managed API (commando's, editor)
• AcDbMgd.dll — database API (objecten, lagen, entiteiten)

Stel voor elke referentie Copy Local = False in. Anders pakt de add-in zijn eigen kopieën mee in plaats van die van AutoCAD.

Stap 3: IExtensionApplication implementeren

Elke AutoCAD add-in heeft een klasse nodig die IExtensionApplication implementeert. AutoCAD roept deze aan bij het laden en sluiten van de add-in.

using Autodesk.AutoCAD.Runtime;

// Verplicht attribuut: vertelt AutoCAD welke klasse de applicatie-entry is
[assembly: ExtensionApplication(typeof(MijnAutoCADAddin.MijnApplicatie))]

namespace MijnAutoCADAddin
{
    /// <summary>
    /// Entry point van de add-in.
    /// AutoCAD roept Initialize() aan bij het laden,
    /// en Terminate() bij het afsluiten van AutoCAD.
    /// </summary>
    public class MijnApplicatie : IExtensionApplication
    {
        public void Initialize()
        {
            // Wordt uitgevoerd zodra AutoCAD de DLL laadt.
            // Ideaal voor het registreren van event handlers of het
            // initialiseren van services.
            Autodesk.AutoCAD.ApplicationServices.Application
                .DocumentManager.MdiActiveDocument
                .Editor.WriteMessage("\nMijn add-in geladen!");
        }

        public void Terminate()
        {
            // Wordt uitgevoerd bij het afsluiten van AutoCAD.
            // Ruim hier resources op (event handlers verwijderen, etc.).
        }
    }
}

Stap 4: Een commando registreren

Nu voegen we een eigen commando toe. Gebruik het attribuut [CommandMethod] om een methode als AutoCAD-commando te registreren:

using Autodesk.AutoCAD.ApplicationServices;
using Autodesk.AutoCAD.DatabaseServices;
using Autodesk.AutoCAD.EditorInput;
using Autodesk.AutoCAD.Runtime;

namespace MijnAutoCADAddin
{
    public class MijnCommando's
    {
        /// <summary>
        /// Commando HELLOVAULT — verschijnt in AutoCAD als je
        /// "HELLOVAULT" intypt in de commandoregel.
        /// </summary>
        [CommandMethod("HELLOKLEVERCAD")]
        public void HelloKleverCAD()
        {
            // Haal de actieve document-editor op
            Document doc    = Application.DocumentManager.MdiActiveDocument;
            Editor   editor = doc.Editor;

            // Schrijf een bericht in de AutoCAD commandoregel
            editor.WriteMessage("\nHallo vanuit KleverCAD! AutoCAD C# add-in werkt.");
        }
    }
}

Stap 5: De add-in laden in AutoCAD

Compileer het project (Ctrl+Shift+B). Je krijgt een .DLL-bestand in de bin\Debug map.

Laad de add-in handmatig in AutoCAD:

1. Open AutoCAD.
2. Typ NETLOAD in de commandoregel en druk op Enter.
3. Blader naar je DLL-bestand en open het.
4. Typ nu HELLOKLEVERCAD — het bericht verschijnt in de commandoregel.

Stap 6: Automatisch laden via een .bundle

Voor een echte installatie gebruik je een bundle: een mapstructuur die AutoCAD automatisch laadt bij het opstarten.

MijnAddin.bundle/
  Contents/
    Windows/
      MijnAutoCADAddin.dll
  PackageContents.xml

Minimale PackageContents.xml:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationPackage
  Name="MijnAddin"
  Description="Mijn eerste AutoCAD add-in"
  Author="KleverCAD">
  <CompanyDetails Name="KleverCAD" />
  <RuntimeRequirements OS="Win64" Platform="AutoCAD" />
  <Components>
    <ComponentEntry
      AppName="MijnAddin"
      ModuleName="./Contents/Windows/MijnAutoCADAddin.dll"
      LoadOnCommandInvocation="False"
      LoadOnAutoCADStartup="True" />
  </Components>
</ApplicationPackage>

Kopieer de hele MijnAddin.bundle map naar:

C:\ProgramData\Autodesk\ApplicationPlugins\

De volgende keer dat AutoCAD start, laadt het je add-in automatisch.

Conclusie

Met deze aanpak heb je een volledig werkende AutoCAD C# add-in gebouwd. Vanaf hier kun je uitbreiden: entiteiten aanmaken, lagen aanpassen, dialoogvensters toevoegen, of verbinding maken met een database. De AutoCAD .NET API geeft je toegang tot vrijwel alles wat je in AutoCAD kunt doen.

In een volgende post behandelen we hoe je je add-in kunt debuggen vanuit Visual Studio — inclusief breakpoints tijdens het draaien in AutoCAD.

What is an AutoCAD add-in?

An AutoCAD add-in is a .NET DLL that AutoCAD loads at startup or on demand. With it you can add your own commands, customise the interface, or automate tasks that would otherwise be done manually.

In this tutorial we use C# and Visual Studio to build a simple add-in that registers a new command in AutoCAD.

What you need

• Visual Studio 2022 (Community edition is free)
• AutoCAD 2025 or later (including the SDK, available from the Autodesk Developer Network)
• Basic C# knowledge (variables, classes, methods)

Step 1: Create a new Class Library project

Open Visual Studio and create a new project:

1. Choose Class Library (.NET Framework) — use .NET Framework 4.8 for AutoCAD 2024 and older, or .NET 8 for AutoCAD 2025+.
2. Name the project, for example MyAutoCADAddin.
3. Click Create.

Important: Do not choose Console App or WinForms. An add-in is always a Class Library (DLL), never an executable.

Step 2: Add AutoCAD references

Your project needs the AutoCAD API libraries. These are located in the AutoCAD installation folder, typically:

C:\Program Files\Autodesk\AutoCAD 2025\

Add the following DLLs as references (Project ? Add Reference ? Browse):

• AcMgd.dll — managed API for AutoCAD applications
• AcCoreMgd.dll — core managed API (commands, editor)
• AcDbMgd.dll — database API (objects, layers, entities)

For each reference, set Copy Local = False. Otherwise the add-in will bundle its own copies instead of using those already loaded by AutoCAD.

Step 3: Implement IExtensionApplication

Every AutoCAD add-in needs a class that implements IExtensionApplication. AutoCAD calls this when the add-in is loaded and when AutoCAD closes.

using Autodesk.AutoCAD.Runtime;

// Required attribute: tells AutoCAD which class is the application entry point
[assembly: ExtensionApplication(typeof(MyAutoCADAddin.MyApplication))]

namespace MyAutoCADAddin
{
    /// <summary>
    /// Entry point of the add-in.
    /// AutoCAD calls Initialize() when loading and Terminate() on shutdown.
    /// </summary>
    public class MyApplication : IExtensionApplication
    {
        public void Initialize()
        {
            // Runs once when AutoCAD loads the add-in.
            // Good place to register event handlers or show a startup message.
            var doc = Autodesk.AutoCAD.ApplicationServices.Application.DocumentManager.MdiActiveDocument;
            doc?.Editor.WriteMessage("\nMyAutoCADAddin loaded successfully.\n");
        }

        public void Terminate()
        {
            // Runs when AutoCAD closes. Clean up resources here.
        }
    }
}

Step 4: Register a custom command

A command is a public method decorated with the [CommandMethod] attribute. AutoCAD discovers all such methods in the loaded DLL automatically.

using Autodesk.AutoCAD.Runtime;
using Autodesk.AutoCAD.ApplicationServices;
using Autodesk.AutoCAD.EditorInput;

namespace MyAutoCADAddin
{
    public class MyCommands
    {
        /// <summary>
        /// Type HELLO in AutoCAD to run this command.
        /// </summary>
        [CommandMethod("HELLO")]
        public void HelloWorld()
        {
            // Get the active document and its editor (command line / console)
            Document doc = Application.DocumentManager.MdiActiveDocument;
            Editor ed = doc.Editor;

            ed.WriteMessage("\nHello from MyAutoCADAddin!\n");
        }
    }
}

Type HELLO in the AutoCAD command line and press Enter — your message will appear.

Step 5: Load the add-in in AutoCAD

Compile the project and load the DLL in AutoCAD:

1. Build the project in Visual Studio (Build ? Build Solution).
2. In AutoCAD, type NETLOAD and press Enter.
3. Browse to the compiled DLL (typically in bin\Debug\ or bin\Release\) and click Open.

For automatic loading at startup, add the DLL path to the AutoCAD Trusted Paths and register it in a .lsp startup file or via the APPLOAD dialog.

Next steps

You now have a working AutoCAD add-in. From here you can:

• Draw entities (lines, circles, text) from C# code
• Read and modify layer properties
• Ask the user for input and selections
• Build a custom ribbon panel or palette

All of these topics are covered in the follow-up posts in this series.