C# voor Inventor: Aan de slag met de Inventor API

Waarom Inventor automatiseren met C#?

Autodesk Inventor stelt vrijwel zijn volledige functieset beschikbaar via een COM-gebaseerde API. Vanuit C# kun je onderdelen, samenstellingen en tekeningen programmatisch aanmaken, parameters aansturen, bestanden exporteren en batchbewerkingen uitvoeren op honderden modellen — alles wat je handmatig kunt doen, kun je scrippen.

Dit bericht richt zich op de snelste weg naar een werkende automatisering: verbinding maken met een actieve Inventor-instantie vanuit een zelfstandige C# console-applicatie. Zodra je het verbindingspatroon begrijpt, volgt de rest — onderdelen, schetsen, parameters — vanzelf.

Vereisten

Visual Studio 2019 of 2022 (Community-editie is gratis)
Autodesk Inventor 2020 of later geïnstalleerd
Basiskennis C# — classes, methoden, using-statements

Twee manieren om Inventor te automatiseren

Voor het schrijven van code helpt het om je opties te kennen:

Externe applicatie — een zelfstandige .exe of console-app die via COM verbinding maakt met een actief Inventor-proces. Het eenvoudigst te ontwikkelen en te debuggen.
Inventor Add-In — een DLL die Inventor bij het opstarten laadt, met directe toegang tot het applicatie-object zonder COM-marshalling. Complexere installatie, maar beter voor productietools.

We beginnen met een externe applicatie. De API-aanroepen zijn identiek bij beide methoden.

Stap 1 — Project aanmaken

Maak in Visual Studio een nieuw Console App (.NET Framework)-project aan met als doel .NET Framework 4.8. Noem het InventorAutomatisering.

Stap 2 — Inventor API-referentie toevoegen

Klik met de rechtermuisknop op References → Add Reference → tabblad COM. Zoek naar Autodesk Inventor Object Library en vink het aan.

Staat het niet in de COM-lijst, blader dan direct naar:

C:\Program Files\Autodesk\Inventor 2024\Bin\Autodesk.Inventor.Interop.dll

Stel Embed Interop Types = False in de referentie-eigenschappen in. Als je dit op True laat staan, krijg je runtime-fouten met Inventor's COM-objecten.

Stap 3 — Verbinding maken en een bestand openen

using System;
using System.Runtime.InteropServices;
using Inventor;  // Autodesk Inventor COM-namespace

namespace InventorAutomatisering
{
    class Program
    {
        static void Main(string[] args)
        {
            Inventor.Application inventorApp = null;

            try
            {
                // Probeer verbinding te maken met een al actieve Inventor-instantie.
                // Als Inventor niet open is, gooit dit een COMException.
                inventorApp = (Inventor.Application)
                    Marshal.GetActiveObject("Inventor.Application");

                Console.WriteLine($"Verbonden met Inventor {inventorApp.SoftwareVersion.DisplayVersion}");
            }
            catch (COMException)
            {
                // Inventor is niet actief — start een nieuwe instantie
                Console.WriteLine("Inventor niet actief. Nieuwe instantie starten...");

                Type inventorType = Type.GetTypeFromProgID("Inventor.Application");
                inventorApp = (Inventor.Application)Activator.CreateInstance(inventorType);
                inventorApp.Visible = true; // venster zichtbaar maken
            }

            // Een bestaand onderdeelbestand openen
            string filePath = @"C:\Modellen\MijnOnderdeel.ipt";
            PartDocument partDoc = (PartDocument)inventorApp.Documents.Open(
                filePath,
                openVisible: true);

            Console.WriteLine($"Geopend: {partDoc.DisplayName}");

            // Een gebruikersparameter uitlezen
            UserParameter lengthParam = partDoc.ComponentDefinition
                .Parameters.UserParameters["Lengte"];

            Console.WriteLine($"Lengte = {lengthParam.Value} mm");

            // Parameterwaarde wijzigen en het model herbouwen
            lengthParam.Value = 150;
            partDoc.Update();

            Console.WriteLine("Parameter bijgewerkt en model herbouwd.");
        }
    }
}

Voer dit uit met een open Inventor-onderdeel dat een gebruikersparameter Lengte heeft en je ziet hem live bijwerken.

Stap 4 — Een nieuw onderdeel vanaf nul aanmaken

Bestaande bestanden openen is nuttig, maar de echte kracht zit in het programmatisch aanmaken van geometrie. Zo maak je een nieuw onderdeel met een geëxtrudeerde rechthoek:

static void MaakGeextrudeerdOnderdeel(Inventor.Application app)
{
    // Nieuw onderdeeldocument aanmaken met het metrisch sjabloon
    string template = app.FileManager.GetTemplateFile(
        DocumentTypeEnum.kPartDocumentObject,
        SystemOfMeasureEnum.kMetricSystemOfMeasure);

    PartDocument doc = (PartDocument)app.Documents.Add(
        DocumentTypeEnum.kPartDocumentObject,
        template,
        createVisible: true);

    PartComponentDefinition compDef = doc.ComponentDefinition;

    // Schets aanmaken op het XY-vlak
    PlanarSketch sketch = compDef.Sketches.Add(
        compDef.WorkPlanes[3]); // WorkPlanes[3] = XY-vlak

    TransientGeometry tg = app.TransientGeometry;

    // Rechthoek van 100x60 mm gecentreerd op het oorsprongspunt
    SketchRectangle rect = sketch.SketchLines.AddAsTwoPointRectangle(
        tg.CreatePoint2d(-50, -30),
        tg.CreatePoint2d( 50,  30));

    // Schetsprofilel extruderen over 40 mm
    Profile profile = sketch.Profiles.AddForSolid();
    ExtrudeFeature extrude = compDef.Features.ExtrudeFeatures.AddByDistanceExtent(
        profile,
        40,
        PartFeatureExtentDirectionEnum.kPositiveExtentDirection,
        PartFeatureOperationEnum.kNewBodyOperation);

    Console.WriteLine($"Extrusie aangemaakt: {extrude.Name}");

    // Bestand opslaan
    doc.SaveAs(@"C:\Modellen\GegenereerdeOnderdeel.ipt", saveMetadata: false);
    Console.WriteLine("Opgeslagen.");
}

Kernconcepten

Het Application-object is het startpunt voor alles. Hiervanuit bereik je Documents, FileManager, UserInterfaceManager en alle andere objecten op het hoogste niveau.

Componentdefinities bevatten de eigenlijke geometrie. Een PartDocument heeft een PartComponentDefinition; een AssemblyDocument heeft een AssemblyComponentDefinition. Features, parameters, schetsen en werkvlakken leven op de componentdefinitie.

TransientGeometry is een fabriek voor tijdelijke geometrie-objecten zoals punten en vectoren die als argumenten in API-aanroepen worden gebruikt. Objecten die via TransientGeometry worden aangemaakt, worden niet aan het model toegevoegd.

Parameters komen in twee soorten: ModelParameters (automatisch aangemaakt door features) en UserParameters (handmatig of via code). Stuur je automatisering altijd aan via gebruikersparameters in plaats van vaste afmetingen, zodat het model bewerkbaar blijft.

Debugtips

Sla een verwijzing op naar een Inventor-documentobject en verken het in het Watch-venster van Visual Studio — het objectmodel is te groot om uit het hoofd te leren; live bladeren is de snelste manier.
Inventor wordt geleverd met een VBA-omgeving (Alt+F11). Eerst prototypen in VBA is vaak sneller dan C# omdat je code kunt uitvoeren zonder te hercompileren.
Schakel COM-uitzonderingsdetails in: ga in Visual Studio naar Debug → Windows → Exception Settings en vink COMException aan.

Wat volgt

Met het verbindingspatroon werkend behandelen de volgende lessen:

Werken met samenstellingen — componenten plaatsen, beperkingen toevoegen
Batchverwerking — door alle bestanden in een map lopen
Automatisch exporteren naar PDF, DWG en STEP
Een echte Inventor Add-In bouwen met een lintknop

De volledige C# voor Inventor-cursus is beschikbaar voor Standard- en Full Access-abonnees in de E-Learning-sectie.

Why automate Inventor with C#?

Autodesk Inventor exposes virtually its entire feature set through a COM-based API. From C# you can create parts, assemblies and drawings programmatically, drive parameters, export files, run batch operations across hundreds of models — anything you can do manually, you can script.

This post focuses on the fastest path to a working automation: connecting to a running Inventor instance from a standalone C# console application. Once you understand the connection pattern, everything else — parts, sketches, parameters — follows naturally.

Prerequisites

Visual Studio 2019 or 2022 (Community edition is free)
Autodesk Inventor 2020 or later installed
Basic C# knowledge — classes, methods, using statements

Two ways to automate Inventor

Before writing code it helps to know your options:

External application — a standalone .exe or console app that connects to a running Inventor process via COM. Easiest to develop and debug.
Inventor Add-In — a DLL that Inventor loads at startup, giving you access to the application object directly without COM marshalling. More complex setup but better for production tools.

We start with an external application. The API calls are identical in both approaches.

Step 1 — Create the project

In Visual Studio, create a new Console App (.NET Framework) project targeting .NET Framework 4.8. Name it InventorAutomation.

Step 2 — Add the Inventor API reference

Right-click References → Add Reference → COM tab. Search for Autodesk Inventor Object Library and check the box.

If it doesn't appear in the COM list, browse directly to:

C:\Program Files\Autodesk\Inventor 2024\Bin\Autodesk.Inventor.Interop.dll

Set Embed Interop Types = False in the reference properties. Leaving it as True causes runtime errors with Inventor's COM objects.

Step 3 — Connect to Inventor and open a file

using System;
using System.Runtime.InteropServices;
using Inventor;  // the Autodesk Inventor COM namespace

namespace InventorAutomation
{
    class Program
    {
        static void Main(string[] args)
        {
            Inventor.Application inventorApp = null;

            try
            {
                // Try to connect to an already-running Inventor instance.
                // If Inventor isn't open, this throws a COMException.
                inventorApp = (Inventor.Application)
                    Marshal.GetActiveObject("Inventor.Application");

                Console.WriteLine($"Connected to Inventor {inventorApp.SoftwareVersion.DisplayVersion}");
            }
            catch (COMException)
            {
                // Inventor isn't running — start a new instance
                Console.WriteLine("Inventor not running. Starting a new instance...");

                Type inventorType = Type.GetTypeFromProgID("Inventor.Application");
                inventorApp = (Inventor.Application)Activator.CreateInstance(inventorType);
                inventorApp.Visible = true; // make the window visible
            }

            // Open an existing part file
            string filePath = @"C:\Models\MyPart.ipt";
            PartDocument partDoc = (PartDocument)inventorApp.Documents.Open(
                filePath,
                openVisible: true);

            Console.WriteLine($"Opened: {partDoc.DisplayName}");

            // Read a user parameter
            UserParameter lengthParam = partDoc.ComponentDefinition
                .Parameters.UserParameters["Length"];

            Console.WriteLine($"Length = {lengthParam.Value} mm");

            // Change the parameter value and update the model
            lengthParam.Value = 150; // Inventor parameters are in cm internally
            partDoc.Update();

            Console.WriteLine("Parameter updated and model rebuilt.");
        }
    }
}

Run this with an Inventor part open that has a user parameter named Length and you'll see it update live.

Step 4 — Create a new part from scratch

Opening existing files is useful, but the real power is creating geometry programmatically. Here's how to create a new part with an extruded rectangle:

static void CreateExtrudedPart(Inventor.Application app)
{
    // Create a new part document using the metric template
    string template = app.FileManager.GetTemplateFile(
        DocumentTypeEnum.kPartDocumentObject,
        SystemOfMeasureEnum.kMetricSystemOfMeasure);

    PartDocument doc = (PartDocument)app.Documents.Add(
        DocumentTypeEnum.kPartDocumentObject,
        template,
        createVisible: true);

    PartComponentDefinition compDef = doc.ComponentDefinition;

    // Create a sketch on the XY plane
    PlanarSketch sketch = compDef.Sketches.Add(
        compDef.WorkPlanes[3]); // WorkPlanes[3] = XY plane

    TransientGeometry tg = app.TransientGeometry;

    // Draw a 100x60 mm rectangle centred at the origin
    SketchRectangle rect = sketch.SketchLines.AddAsTwoPointRectangle(
        tg.CreatePoint2d(-50, -30),
        tg.CreatePoint2d( 50,  30));

    // Extrude the sketch profile by 40 mm
    Profile profile = sketch.Profiles.AddForSolid();
    ExtrudeFeature extrude = compDef.Features.ExtrudeFeatures.AddByDistanceExtent(
        profile,
        40,                                  // distance in mm (if default units are mm)
        PartFeatureExtentDirectionEnum.kPositiveExtentDirection,
        PartFeatureOperationEnum.kNewBodyOperation);

    Console.WriteLine($"Created extrude: {extrude.Name}");

    // Save the file
    doc.SaveAs(@"C:\Models\GeneratedPart.ipt", saveMetadata: false);
    Console.WriteLine("Saved.");
}

Key concepts to understand

The Application object is the entry point to everything. From it you reach Documents, FileManager, UserInterfaceManager, and all other top-level objects.

Component definitions hold the actual geometry. A PartDocument has a PartComponentDefinition; an AssemblyDocument has an AssemblyComponentDefinition. Features, parameters, sketches and work geometry all live on the component definition.

TransientGeometry is a factory for throwaway geometry objects like points and vectors used in API calls. Objects created through TransientGeometry are not added to the model — they're just used as arguments.

Parameters come in two flavours: ModelParameters (created automatically by features) and UserParameters (created manually or by code). Always drive your automation through user parameters rather than hard-coded distances so the model stays editable.

Debugging tips

Set a reference to an Inventor document object and explore it in the Visual Studio Watch window — the object model is too large to memorise, so browsing live objects is the fastest way to learn it.
Inventor ships with a VBA environment (Alt+F11). Prototyping in VBA first is often faster than C# because you can run code without recompiling.
Enable COM exception details: in Visual Studio go to Debug → Windows → Exception Settings and check COMException.

What's next

With the connection pattern working, the next lessons cover:

Working with assemblies — placing components, adding constraints
Batch processing — looping through all files in a folder
Exporting to PDF, DWG, and STEP automatically
Building a proper Inventor Add-In with a ribbon button

The full C# for Inventor course is available to Standard and Full Access subscribers in the E-Learning section.

C# voor Inventor: Aan de slag met de Inventor API

Waarom Inventor automatiseren met C#?

Vereisten

Twee manieren om Inventor te automatiseren

Stap 1 — Project aanmaken

Stap 2 — Inventor API-referentie toevoegen

Stap 3 — Verbinding maken en een bestand openen

Stap 4 — Een nieuw onderdeel vanaf nul aanmaken

Kernconcepten

Debugtips

Wat volgt

Why automate Inventor with C#?

Prerequisites

Two ways to automate Inventor

Step 1 — Create the project

Step 2 — Add the Inventor API reference

Step 3 — Connect to Inventor and open a file

Step 4 — Create a new part from scratch

Key concepts to understand

Debugging tips

What's next

Comments

Leave a comment

C# voor Inventor: Aan de slag met de Inventor API

Waarom Inventor automatiseren met C#?

Vereisten

Twee manieren om Inventor te automatiseren

Stap 1 — Project aanmaken

Stap 2 — Inventor API-referentie toevoegen

Stap 3 — Verbinding maken en een bestand openen

Stap 4 — Een nieuw onderdeel vanaf nul aanmaken

Kernconcepten

Debugtips

Wat volgt

Why automate Inventor with C#?

Prerequisites

Two ways to automate Inventor

Step 1 — Create the project

Step 2 — Add the Inventor API reference

Step 3 — Connect to Inventor and open a file

Step 4 — Create a new part from scratch

Key concepts to understand

Debugging tips

What's next

More articles

Comments

Leave a comment