Je AutoCAD C# add-in debuggen in Visual Studio

Waarom is debuggen van add-ins anders?

Normaal start je een applicatie vanuit Visual Studio en debug je hem direct. Bij een AutoCAD add-in is dat anders: jouw code draait inside AutoCAD, niet als zelfstandig programma. Je moet Visual Studio dus koppelen aan het lopende AutoCAD-proces — dit heet attach to process.

Methode 1: Handmatig laden met NETLOAD (snelste voor development)

Tijdens ontwikkeling laad je de add-in het best handmatig, zodat je AutoCAD niet elke keer hoeft te herstarten.

1. Compileer je project in Visual Studio (Ctrl+Shift+B).
2. Open AutoCAD.
3. Typ NETLOAD in de commandoregel.
4. Blader naar de DLL in je bin\Debug map en open hem.

Zet daarna een breakpoint in Visual Studio en koppel Visual Studio aan AutoCAD (zie hieronder). Dit is de snelste ontwikkelcyclus.

Voordeel van NETLOAD boven een bundle: je hoeft AutoCAD niet te herstarten na elke wijziging. Laad de DLL opnieuw zodra je een nieuwe versie hebt gebuild.

Methode 2: Debug-project instellen (automatisch starten)

Je kunt Visual Studio zo instellen dat het AutoCAD automatisch start en de debugger eraan koppelt wanneer je op F5 drukt:

1. Klik rechts op je project ? Properties.
2. Ga naar het tabblad Debug.
3. Kies Start external program en browse naar:

C:\Program Files\Autodesk\AutoCAD 2025\acad.exe

4. Zorg dat je DLL als bundle of via AutoCAD's zoekpad geladen wordt bij het opstarten.
5. Druk op F5 — AutoCAD start en Visual Studio koppelt automatisch.

Methode 3: Attach to Process (altijd beschikbaar)

Als AutoCAD al draait, kun je Visual Studio er op elk moment aan koppelen:

1. Zorg dat je add-in geladen is in AutoCAD (via NETLOAD of bundle).
2. Ga in Visual Studio naar Debug ? Attach to Process (Ctrl+Alt+P).
3. Zoek in de lijst naar acad.exe.
4. Klik op Attach.

Vanaf nu werken je breakpoints wanneer AutoCAD code uitvoert die door jouw add-in geleverd wordt.

Breakpoints instellen

Zet een breakpoint door te klikken op de grijze marge links van een regel code (er verschijnt een rode stip). Wanneer AutoCAD die regel bereikt, pauzeert de uitvoering en kun je:

• Variabelen inspecteren in het Locals of Watch venster
• Stap voor stap door de code lopen met F10 (over) of F11 (in)
• De call stack bekijken om te zien hoe je hier terecht bent gekomen
• Variabelen live aanpassen via het Immediate Window

Veelvoorkomende problemen en oplossingen

Probleem: "No symbols have been loaded for this document"

Visual Studio vindt de debug-symbolen niet. Controleer:

• Compileer je in Debug-modus (niet Release)? Check de dropdown bovenaan Visual Studio.
• Is het .pdb-bestand aanwezig naast de DLL? Dat bestand bevat de debug-symbolen.
• Is de geladen DLL precies dezelfde als de DLL in je bin\Debug? Als je de DLL ergens anders hebt gekopieerd, zorg dan dat je de nieuwste versie laadt.

Probleem: AutoCAD crasht bij het laden van de DLL

De meest voorkomende oorzaken:

• Verkeerde .NET versie: Gebruik je .NET 8 voor AutoCAD 2024 of ouder? Dat werkt niet — gebruik .NET Framework 4.8 voor AutoCAD 2024 en ouder, .NET 8 voor AutoCAD 2025+.
• Copy Local = True op AutoCAD-referenties: Als je AcMgd.dll meebundelt in je uitvoermap, conflicteert die met de versie van AutoCAD. Zet Copy Local altijd op False.
• Bitness-mismatch: Zorg dat je project als x64 compileert (AutoCAD is 64-bit).

Probleem: Breakpoint wordt niet geraakt

• Is de debugger gekoppeld aan acad.exe? Check de statusbalk onderin Visual Studio — die toont de Debug-sessie.
• Heb je de code opnieuw gecompileerd ná het instellen van het breakpoint?
• Zit het breakpoint in een methode die ook echt aangeroepen wordt vanuit AutoCAD?

Probleem: "The process cannot access the file because it is being used by another process"

AutoCAD houdt de DLL vergrendeld zolang hij geladen is. Je kunt een geladen DLL niet overschrijven. Oplossingen:

• Sluit AutoCAD volledig af, compileer opnieuw, en start AutoCAD weer.
• Gebruik een tool als Assembly Unload (beschikbaar als AutoCAD add-in) om de DLL te ontladen zonder AutoCAD te herstarten.
• Geef de DLL een nieuw versienummer zodat het een ander bestand wordt (minder handig).

Tip: gebruik de Output-venster voor snelle logging

Schrijf tussentijdse informatie naar de AutoCAD commandoregel zodat je het gedrag kunt volgen zonder een volledige debugsessie:

// Schrijf een debug-bericht naar de AutoCAD commandoregel
var doc    = Application.DocumentManager.MdiActiveDocument;
var editor = doc.Editor;
editor.WriteMessage($"\n[DEBUG] Waarde van x: {x}");

Dit is handig voor snelle sanity checks zonder dat je de debugger hoeft te koppelen.

Conclusie

Debuggen van AutoCAD add-ins is even anders dan een gewone applicatie debuggen, maar eenmaal ingesteld werkt het uitstekend. De combinatie van Attach to Process, NETLOAD voor snelle iteratie, en de volledige Visual Studio debugger maakt het ontwikkelen van AutoCAD tools een stuk aangenamer.

Why is debugging an add-in different?

Normally you press F5 in Visual Studio and the debugger starts your application. With an AutoCAD add-in the situation is reversed: AutoCAD is the host process, and you need to attach Visual Studio to it after AutoCAD has loaded your DLL.

Method 1: Attach to Process (simplest)

1. Build your add-in in Debug configuration.
2. Start AutoCAD and load your DLL with NETLOAD.
3. In Visual Studio: Debug ? Attach to Process… (Ctrl+Alt+P).
4. Find acad.exe in the list and click Attach.
5. Set breakpoints in your code — they will be hit the next time you run your command in AutoCAD.

Tip: If your DLL is already loaded but symbols are not found, check that the .pdb file is in the same folder as the .dll.

Method 2: Launch AutoCAD from Visual Studio (F5)

This approach starts AutoCAD directly from Visual Studio so the debugger attaches from the beginning. In Visual Studio:

1. Right-click the project ? Properties ? Debug tab.
2. Set Start external program to the AutoCAD executable, e.g.:
   C:\Program Files\Autodesk\AutoCAD 2025\acad.exe
3. Press F5. AutoCAD starts with the debugger attached.
4. Load your DLL with NETLOAD and trigger your command.

Method 3: Auto-load at AutoCAD startup

For a smoother workflow, register the DLL to load automatically so you skip the NETLOAD step each time. Add the following to a startup LISP file (acad.lsp or acaddoc.lsp):

(command "_.NETLOAD" "C:\\Path\\To\\MyAutoCADAddin.dll")

Or use the APPLOAD dialog to add the DLL to the startup suite.

Common debugging scenarios

Breakpoint not hit

• Make sure you built in Debug configuration (not Release).
• Verify the .pdb file is present next to the .dll.
• Check that the loaded DLL is the one you just built (use Modules window in Visual Studio to confirm).

Exception: AutoCAD crashes

• Enable Break when thrown for CLR exceptions: Debug ? Windows ? Exception Settings ? check Common Language Runtime Exceptions.
• Look for unhandled exceptions in the Output window or the AutoCAD crash log (%LOCALAPPDATA%\Autodesk\AutoCAD 2025\CER\).

Inspecting AutoCAD objects

Use the Watch window to inspect AutoCAD objects during execution:

// In the Watch window, type:
doc.Database.LayerTableId
// or drill into the entity you just modified:
entity.Layer

Hot reload: editing without restarting AutoCAD

Visual Studio's Edit and Continue does not work with AutoCAD add-ins because the DLL is locked while AutoCAD holds it. The fastest iteration loop is:

1. Use NETUNLOAD to unload your DLL in AutoCAD.
2. Rebuild in Visual Studio.
3. Use NETLOAD to reload.

Some developers automate this with a small AutoLISP macro that runs NETUNLOAD + NETLOAD in sequence.

Useful Visual Studio windows

• Call Stack — see exactly which code path led to the current line
• Locals / Watch — inspect variable values at runtime
• Immediate Window — execute C# expressions while paused at a breakpoint
• Modules — confirm which version of your DLL is loaded
• Output — see Debug.WriteLine messages without a breakpoint