Erstellen einer domänenspezifischen Sprachlösung
Eine domänenspezifische Sprache (DSL) wird mithilfe einer speziellen Visual Studio-Projektmappe erstellt.
Voraussetzungen
Bevor Sie mit diesem Verfahren beginnen können, installieren Sie die folgenden Komponenten:
- Visual Studio
- Visual Studio SDK (installiert als Teil der Workload für die Entwicklung von Visual Studio-Erweiterungen)
- Modellierungs-SDK (installiert als Visual Studio-Komponente)
Hinweis
Die Komponente Textvorlagentransformation wird automatisch als Teil der Workload Visual Studio-Erweiterungsentwicklung installiert. Sie können die Installation auch über die Registerkarte Einzelne Komponenten des Visual Studio-Installers unter der Kategorie SDKs, Bibliotheken und Frameworks durchführen. Installieren Sie die Komponente Modellierungs-SDK auf der Registerkarte Einzelne Komponenten.
Erstellen einer DSL-Projektmappe
Starten Sie den DSL-Assistenten, indem Sie ein neues Projekt für den DSL-Designer erstellen.
Hinweis
Vorzugsweise sollte der für das Projekt gewählte Name ein gültiger Visual C#-Bezeichner sein, da er möglicherweise zum Generieren von Code verwendet wird.
Wählen Sie eine DSL-Vorlage aus.
Wählen Sie auf der Seite Optionen für domänenspezifische Sprachen auswählen eine der Projektmappenvorlagen aus, z. B. Minimale Sprache. Wählen Sie eine Vorlage ähnlich der DSL aus, die Sie erstellen möchten.
Weitere Informationen zu Projektmappenvorlagen finden Sie unter Auswählen einer Projektmappenvorlage für eine domänenspezifische Sprache.
Geben Sie auf der Seite Dateierweiterung eine Dateiendung ein. Diese sollte auf Ihrem Computer und auf allen Computern, auf denen Sie die DSL installieren möchten, eindeutig sein. Die Meldung Keine Anwendungen oder Visual Studio-Editoren verwenden diese Erweiterung sollte angezeigt werden.
Wenn Sie die Dateiendung in früheren experimentellen DSLs verwendet haben, die noch nicht vollständig installiert wurden, können Sie sie mithilfe des Tools Experimentelle Instanz zurücksetzen löschen, das sie im Menü des Visual Studio SDK finden.
Wenn eine andere Visual Studio-Erweiterung, die diese Dateiendung verwendet, vollständig auf Ihrem Computer installiert wurde, sollten Sie sie deinstallieren. Klicken Sie im Menü Extras auf Erweiterungs-Manager.
Überprüfen Sie die Felder auf den verbleibenden Seiten des Assistenten, und passen Sie sie ggf. an. Wenn Sie mit den Einstellungen zufrieden sind, klicken Sie auf Fertig stellen. Weitere Informationen zu den Einstellungen finden Sie unter Seiten des DSL-Designer-Assistenten.
Der Assistent erstellt eine Projektmappe mit zwei Projekten mit den Namen Dsl und DslPackage.
Hinweis
Wenn Sie in einer Meldung davor gewarnt werden, Textvorlagen aus nicht vertrauenswürdigen Quellen ausführen, klicken Sie auf OK. Sie können festlegen, dass diese Meldung nicht mehr angezeigt wird.
Die Seiten des DSL-Designer-Assistenten
Sie können für einige der Felder die Standardwerte unverändert lassen. Stellen Sie jedoch sicher, das Feld „Dateierweiterung“ festzulegen.
Seite „Projektmappeneinstellungen“
Auf welcher Vorlage soll die domänenspezifische Sprache basieren? Wählen Sie eine Vorlage ähnlich der DSL aus, die Sie erstellen möchten. Die verschiedenen Vorlagen bieten praktische Ausgangspunkte. Wenn Sie eine Projektmappenvorlage auswählen, wird im Assistenten eine Beschreibung angezeigt. Weitere Informationen zu Projektmappenvorlagen finden Sie unter Auswählen einer Projektmappenvorlage für eine domänenspezifische Sprache.
Wie möchten Sie die domänenspezifische Sprache nennen? Standardmäßig wird der Name der Projektmappe verwendet. Aus diesem Wert wird Code generiert. Es muss sich um einen gültigen C#-Klassennamen handeln.
Seite „Dateierweiterung“
Welches Suffix sollen Modelldateien verwenden? Geben Sie eine neue Dateiendung ein.
Stellen Sie wie folgt sicher, dass diese Dateiendung noch nicht für die Verwendung auf diesem Computer registriert wurde:
Sehen Sie unter Andere für die Verwendung dieser Erweiterung registrierte Tools und Anwendungen nach. Wenn die Meldung Keine Anwendungen oder Visual Studio-Editoren verwenden diese Erweiterung angezeigt wird, können Sie diese Dateiendung verwenden.
Wenn eine Liste mit Tools oder Paketen angezeigt wird, sollten Sie eine der folgenden Aktionen ausführen:
Geben Sie eine andere Dateiendung ein.
- oder -
Setzen Sie die experimentelle Instanz von Visual Studio zurück. Dadurch wird die Registrierung aller zuvor erstellten DSLs aufgehoben. Wechseln Sie ins Windows-Startmenü, setzen Sie Visual Studio zurück, und führen Sie dann den Befehl Microsoft Visual Studio Experimental Instance zurücksetzen aus, der Ihrer Version von Visual Studio entspricht. Sie können alle anderen DSLs, die Sie wiederverwenden möchten, neu erstellen.
- oder -
Wenn eine Visual Studio-Erweiterung, die diese Dateiendung verwendet, vollständig auf Ihrem Computer installiert wurde, deinstallieren Sie sie. Klicken Sie im Menü Extras auf Erweiterungs-Manager.
Seite „Produkteinstellungen“
Wie lautet der Name des Produkts, zu dem die neue domänenspezifische Sprache gehört? Standardmäßig wird der DSL-Name verwendet.
Mit diesem Wert werden im Windows-Explorer (oder Datei-Explorer) Dateien beschrieben, die diese Dateiendung aufweisen.
Wie lautet der Name des Unternehmens, zu dem das Produkt gehört? Der Name Ihres Unternehmens.
Dieser Wert wird in die AssemblyInfo-Eigenschaften Ihres DSL-Pakets integriert.
Wie lautet der Stammnamespace für Projekte in dieser Projektmappe? Dieser Name setzt sich standardmäßig aus Ihrem Firmen- und Ihrem Produktnamen zusammen.
Seite „Signatur“
Erstellen einer Schlüsseldatei mit starkem Namen: Die Standardoption besteht darin, einen neuen Schlüssel zum Signieren Ihrer DSL-Assembly zu erstellen.
Vorhandenen Schlüssel mit starkem Namen verwenden: Verwenden Sie diese Option, wenn Sie Ihre DSL in eine andere Assembly integrieren möchten.
Weitere Informationen zu starken Namen finden Sie unter Erstellen und Verwenden von Assemblys mit starkem Namen.