Projekt in Visual Studio erstellen

Microsoft Visual Studio (Stand: Version 2022) gibt es in verschiedenen Versionen:

  • Visual Studio Community

  • Visual Studio Professional

  • Visual Studio Enterprise

Für das Scripting ist die kostenlose Community Edition vollkommen ausreichend. Hier muss auf die Lizenzenzbestimmungen geachtet werden.

Den Download findet man auf https://visualstudio.microsoft.com.

Für die Entwicklung von Scripten muss der Workload .NET-Desktopentwicklung aktiviert sein. Diese Komponente kann auch nachträglich über das Programm Visual Studio Installer installiert werden.

Es ist zu empfehlen Visual Studio in englischer Oberfläche zu starten. Die Dokumentation zu Funktionen der Software oder auch Diskussionen in Communities sind dadurch leichter nachvollziehbar.

Die Sprache kann unter Extras > Optionen > Umgebung > Internationale Einstellungen > Sprache umgestellt werden.

Nun starten wir die Applikation und erstellen ein neues Projekt. Hierfür gibt es mehrere Wege:

  • über Create a new project... auf dem Startbildschirm
  • über File > New > Project..., falls Visual Studio bereits geöffnet ist

Neues Projekt |

Neues Projekt erstellen |

Je nachdem, in welcher Version Visual Studio installiert wurde bzw. mit welchem Funktionsumfang, sind mehrere Projektvorlagen verfügbar. Wir wählen als Sprache C#, als Plattform Windows und als Projekttyp Library aus. Nun wählen wir Class Library (.NET Framework) und klicken auf Next.

Neues Projekt erstellen

Wir vergeben als Projektnamen und Namen der Projektmappe EPLAN Scripting Project und definieren einen gewünschten Speicherort. Die Option Place solution and project in the same directory lassen wir deaktiviert, und als Zielframework wählen wir das für EPLAN 2025 gültige .NET Framework 4.8.1.

Mit Betätigung des Buttons Create werden die Dateien erzeugt und das Projekt geöffnet. Nun sehen wir schon die ersten Codezeilen. Für uns ist es jedoch wichtig, zunächst alle EPLAN-relevanten Daten zu laden. Dazu blenden wir über View > Solution Explorer den Projektmappen-Explorer, falls dieser nicht sichtbar ist, ein.

Projektmappen-Explorer einblenden

Der Aufbau des Projektmappen-Explorers sieht folgendermaßen aus:

  • Name der Visual Studio-Projektmappe (kann aus mehreren Projekten bestehen)
  • Name des Projekts
  • Properties (Eigenschaften)
  • Verweise (Verknüpfungen)
  • Programmdateien (hier können wir auch Ordner anlegen)

Projektmappen-Explorer |

Die Navigatoren in Visual Studio können wir an die Seitenränder minimieren. Mit der Stecknadel wird symbolisiert, ob der Navigator nach dem Verlassen der Maus automatisch minimiert wird oder nicht.

Um EPLAN-Funktionalitäten im Programmcode nutzen zu können, müssen wir einige Dateien laden. Dazu führen wir einen Rechtsklick auf References aus und wählen Add Reference.

Verweis hinzufügen

Wir wechseln nun in den Tab Durchsuchen und wählen über den gleichnamigen Button den EPLAN-Installationsordner (z. B. C:\Program Files\EPLAN\Platform\2026.0.1\Bin) aus. Hier markieren wir folgende Dateien:

  • Eplan.EplApi.AFu.dll
  • Eplan.EplApi.Baseu.dll
  • Eplan.EplApi.Guiu.dll
  • Eplan.EplApi.MasterDatau.dll
  • Newtonsoft.Json.dll

EPLAN-Verweise hinzufügen |

Zusätzlich zu den EPLAN DLL-Dateien sind noch folgende Assemblys aus dem Framework im Scripting erlaubt:

  • System

  • System.Drawing

  • System.Net.Http

  • System.Windows.Forms

  • System.XML

Wir fügen die Verweise über den Tab Assemblys hinzu.

Windows-Forms-Verweis hinzufügen

Nicht erlaubte Verweise entfernen wir über das Kontextmenü. Nun sollten die in dargestellten References sichtbar sein.

Sichtbare Verweise

Nun kommen wir zur eigentlichen Programmdatei Class1.cs. Diese benennen wir in 01_Start.cs um. Die Endung *.cs steht für C#. Zur besseren Übersicht gliedern wir die Scriptdateien in Ordner. Mit einem Rechtsklick auf Project > Add > New Folder erstellen wir den Ordner 01_FirstSteps.

image-20250508081554456

image-20250508084135941

Mit File > Save All speichern wir die Projektmappe ab.

image-20250508084220849