Comment : créer une solution de langage spécifique à un domaineHow to: Create a Domain-Specific Language Solution

Un langage spécifique à un domaine (DSL) est créé à l’aide de spécialisé Visual StudioVisual Studio solution.A domain-specific language (DSL) is created by using a specialized Visual StudioVisual Studio solution.

PrérequisPrerequisites

Avant de commencer cette procédure, vous devez d’abord installer ces composants :Before you can start this procedure, you must first install these components:

Visual StudioVisual Studio http://go.microsoft.com/fwlink/?LinkID=185579
Kit de développement logiciel Visual StudioVisual Studio SDK http://go.microsoft.com/fwlink/?LinkID=185580
Kit de développement logiciel (SDK) Visual Studio Visualization and ModelingVisual Studio Visualization and Modeling SDK

Note

Dans Visual Studio 2017, le SDK de Transformation de modèle de texte et le SDK de modélisation de Visual Studio sont installés automatiquement lorsque vous installez des fonctionnalités spécifiques de Visual Studio.In Visual Studio 2017, the Text Template Transformation SDK and the Visual Studio Modeling SDK are installed automatically when you install specific features of Visual Studio. Pour plus d’informations, consultez ce billet de blog.For more details, see this blog post.

Création d’une Solution de langage spécifique à un domaineCreating a Domain-Specific Language Solution

Pour créer une solution de langage spécifique à un domaineTo create a domain-specific language solution

  1. Démarrez l’Assistant DSL.Start the DSL Wizard.

    1. Dans le menu Fichier , pointez sur Nouveau, puis cliquez sur Projet.On the File menu, point to New, and then click Project.

    2. La boîte de dialogue Nouveau projet s’affiche.The New Project dialog box appears.

    3. Sous types de projet, développez le autres Types de projets nœud, puis cliquez sur extensibilité.Under Project types, expand the Other Project Types node, and click Extensibility.

    4. Cliquez sur Concepteur de langage spécifique à un domaine.Click Domain-Specific Language Designer.

    5. Dans le nom , tapez un nom pour la solution.In the Name box, type a name for the solution. Cliquez sur OK.Click OK.

      Le Assistant Concepteur de langage spécifique à un domaine s’affiche.The Domain-Specific Language Designer Wizard appears.

      Note

      De préférence, le nom que vous tapez doit être un identificateur c# valide, car il peut être utilisé pour générer le code.Preferably, the name that you type should be a valid Visual C# identifier, because it might be used to generate code.

      Boîte de dialogue Créer DSL

  2. Choisissez un modèle DSL.Choose a DSL template.

    Sur le sélectionner les Options de langage spécifique à un domaine page, sélectionnez un des modèles de solution telle que langage minimale.On the Select Domain-Specific Language Options page, select one of the solution templates such as Minimal Language. Choisissez un modèle qui est similaire à la DSL que vous souhaitez créer.Choose a template that is similar to the DSL that you want to create.

    Pour plus d’informations sur les modèles de solution, consultez choisir un modèle de Solution de langage spécifique à un domaine.For more information about solution templates, see Choosing a Domain-Specific Language Solution Template.

  3. Entrez une extension de nom de fichier sur le Extension de fichier page.Enter a filename extension on the File Extension page. Il doit être unique dans votre ordinateur, et dans tous les ordinateurs sur lesquels vous souhaitez installer le DSL.It should be unique in your computer, and in any computers on which you want to install the DSL. Vous devez voir le message aucune application ou les éditeurs de Visual Studio n’utilisent cette extension.You should see the message No applications or Visual Studio editors use this extension.

    • Si vous avez utilisé l’extension de nom de fichier dans DSL expérimentale précédente qui n’ont pas été entièrement installé, vous pouvez les désactiver à l’aide de la réinitialiser l’Instance expérimentale outil, qui se trouve dans le Visual StudioVisual Studio menu du Kit de développement logiciel.If you have used the file name extension in previous experimental DSLs that have not been fully installed, you can clear them out by using the Reset the Experimental Instance tool, which can be found in the Visual StudioVisual Studio SDK menu.

    • Si un autre Visual StudioVisual Studio Extension qui utilise cette extension de fichier a été entièrement installée sur votre ordinateur, envisagez de le désinstaller.If another Visual StudioVisual Studio Extension that uses this file extension has been fully installed on your computer, consider uninstalling it. Sur le outils menu, cliquez sur Gestionnaire d’extensions.On the Tools menu, click Extension Manager.

  4. Examiner et ajuster si nécessaire, les champs dans les pages restantes de l’Assistant.Inspect, and if necessary adjust, the fields in the remaining pages of the wizard. Lorsque vous êtes satisfait des paramètres, cliquez sur Terminer.When you are satisfied with the settings, click Finish. Pour plus d’informations sur les paramètres, consultez Pages de l’Assistant concepteur DSL.For more information about the settings, see DSL Designer Wizard Pages.

    L’Assistant crée une solution qui contient deux projets, qui sont nommées Dsl et DslPackage.The wizard creates a solution that has two projects, which are named Dsl and DslPackage.

    Note

    Si vous voyez un message qui vous n'avertit pas pour exécuter des modèles de texte à partir de sources non fiables, cliquez sur OK.If you see a message that alerts you not to run text templates from untrusted sources, click OK. Vous pouvez définir ce message s’affiche à nouveau.You can set this message not to appear again.

Les Pages de l’Assistant concepteur DSLThe DSL Designer Wizard Pages

Vous pouvez laisser certains champs identique à leurs valeurs par défaut.You can leave several of the fields unchanged from their default values. Toutefois, assurez-vous que vous définissez le champ d’Extension de fichier.However, make sure that you set the File Extension field.

Page Paramètres de solutionSolution Settings page

Quel est le modèle vous voulez baser votre langage spécifique à un domaine sur ?Which Template would you like to base your domain specific language on? Choisissez un modèle qui est similaire à la DSL que vous souhaitez créer.Choose a template that is similar to the DSL that you want to create. Les différents modèles fournissent des points de départ pratiques.The different templates provide convenient starting points. Lorsque vous sélectionnez un modèle de solution, l’Assistant affiche une description.When you select a solution template, the wizard displays a description. Pour plus d’informations sur les modèles de solution, consultez choisir un modèle de Solution de langage spécifique à un domaine.For more information about solution templates, see Choosing a Domain-Specific Language Solution Template.

Que voulez-vous nommer votre langage spécifique à un domaine ?What do you want to name your domain-specific language? Par défaut, le nom de la solution.Defaults to the solution name. Code est généré à partir de cette valeur.Code is generated from this value. Il doit être valide comme nom de classe c#.It must be valid as a C# class name.

Page Extension de fichierFile Extension page

Les extensions doivent modéliser de fichiers utilisent ?What extension should model files use? Tapez une nouvelle extension de fichier.Type a new file extension.

Vérifiez que cette extension de fichier n'a pas déjà été inscrit pour une utilisation sur cet ordinateur, comme suit :Verify that this file extension has not already been registered for use in this computer, as follows:

Regardez sous autres outils et applications inscrit pour gérer cette extension.Look under Other tools and applications registered to handle this extension. Si vous voyez le message aucune application ou les éditeurs de Visual Studio n’utilisent cette extension, vous pouvez ensuite utiliser cette extension de fichier.If you see the message No applications or Visual Studio editors use this extension, then you can use this file extension.

Si vous voyez une liste des outils ou des packages, vous devez procédez à une des opérations suivantes :If you see a list of tools or packages, you should do one of the following:

  • Tapez une extension de fichier différent.Type a different file extension.

    - ou -- or -

  • Réinitialiser le Visual StudioVisual Studio Instance expérimentale.Reset the Visual StudioVisual Studio Experimental Instance. Cela annulera toutes les DSL que vous avez déjà créé.This will unregister all of the DSLs that you have previously built. Sur le Démarrer menu, cliquez sur tous les programmes, Microsoft Visual Studio 2010 SDK, outils, puis réinitialiser le Instance de Microsoft Visual Studio 2010 expérimentale.On the Start menu, click All Programs, Microsoft Visual Studio 2010 SDK, Tools, and then Reset the Microsoft Visual Studio 2010 Experimental instance. Vous pouvez reconstruire les autres DSL que vous souhaitez utiliser à nouveau.You can rebuild any other DSLs that you want to use again.

    - ou -- or -

  • Si un Visual StudioVisual Studio Extension qui utilise cette extension de fichier a été entièrement installée sur votre ordinateur, désinstallez-la.If a Visual StudioVisual Studio Extension that uses this file extension has been fully installed on your computer, uninstall it. Sur le outils menu, cliquez sur Gestionnaire d’extensions.On the Tools menu, click Extension Manager.

Page des paramètres de produitProduct Settings page

Quel est le nom du produit auquel appartient le nouveau langage spécifique à un domaine ?What is the name of the product that the new domain-specific language belongs to? Par défaut, le nom DSL.Defaults to the DSL name.

Cette valeur est utilisée dans l’Explorateur Windows (ou l’Explorateur de fichiers) pour décrire les fichiers ayant cette extension de fichier.This value is used in Windows Explorer (or File Explorer) to describe files that have this file extension.

Quel est le nom de la société à laquelle appartient le produit ?What is the name of the company that the product belongs to? Nom de votre société.Your company name.

Cette valeur est incorporée dans les propriétés AssemblyInfo de votre package DSL.This value is incorporated into the AssemblyInfo properties of your DSL package.

Quel est l’espace de noms racine pour les projets dans cette solution ?What is the root namespace for projects in this solution? L’emplacement par défaut pour un nom composé à partir de votre entreprise et les noms de produits.This defaults to a name composed from your company and product names.

Page signatureSigning page

Créer un fichier de clé de nom fort l’option par défaut consiste à créer une nouvelle clé pour signer votre assembly DSL.Create a strong name key file The default option is to create a new key to sign your DSL assembly.

Utilisez la clé de nom fort existant Utilisez cette option si vous souhaitez intégrer votre DSL avec un autre assembly.Use existing strong name key Use this option if you want to integrate your DSL with another assembly.

Pour plus d’informations sur les noms forts, consultez création et assemblys avec nom fort.For more information about strong naming, see Creating and Using Strong-Named Assemblies.

Voir aussiSee also