Inscription de générateurs de fichier uniqueRegistering Single File Generators

Pour mettre à disposition dans un outil personnalisé Visual StudioVisual Studio, vous devez l’inscrire donc Visual StudioVisual Studio peut instancier et l’associe à un type de projet particulier.To make a custom tool available in Visual StudioVisual Studio, you must register it so Visual StudioVisual Studio can instantiate it and associates it with a particular project type.

Pour inscrire un outil personnaliséTo register a custom tool

  1. Inscrire l’outil personnalisé DLL soit dans le Visual StudioVisual Studio Registre local ou dans le Registre système, sous HKEY_CLASSES_ROOT.Register the custom tool DLL either in the Visual StudioVisual Studio local registry or in the system registry, under HKEY_CLASSES_ROOT.

    Par exemple, voici les informations d’inscription pour l’outil personnalisé MSDataSetGenerator géré, est fourni avec Visual StudioVisual Studio:For example, here's the registration information for the managed MSDataSetGenerator custom tool, which comes with Visual StudioVisual Studio:

    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\14.0\CLSID\{E76D53CC-3D4F-40A2-BD4D-4F3419755476}]  
    @="COM+ class: Microsoft.VSDesigner.CodeGenerator.TypedDataSourceGenerator.DataSourceGeneratorWrapper"  
    "InprocServer32"="C:\\WINDOWS\\system32\\mscoree.dll"  
    "ThreadingModel"="Both"  
    "Class"="Microsoft.VSDesigner.CodeGenerator.TypedDataSourceGenerator.DataSourceGeneratorWrapper"  
    "Assembly"="Microsoft.VSDesigner, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=b03f5f7f11d50a3a"  
    
  2. Créer une clé de Registre dans le texte souhaité Visual StudioVisual Studio hive sous générateurs\GUIDGUID est le GUID défini par le système de projet ou le service de langage spécifique.Create a registry key in the desired Visual StudioVisual Studio hive under Generators\GUID where GUID is the GUID defined by the specific language's project system or service. Le nom de la clé devient le nom de programmation de votre outil personnalisé.The name of the key becomes the programmatic name of your custom tool. La clé de l’outil personnalisé a les valeurs suivantes :The custom tool key has the following values:

    • (Default)(Default)

      Facultatif.Optional. Fournit une description conviviale de l’outil personnalisé.Provides a user-friendly description of the custom tool. Ce paramètre est facultatif mais recommandé.This parameter is optional, but recommended.

    • CLSIDCLSID

      Obligatoire.Required. Spécifie l’identificateur de la bibliothèque de classes du composant COM qui implémente IVsSingleFileGenerator.Specifies the identifier of the class library of the COM component that implements IVsSingleFileGenerator.

    • GeneratesDesignTimeSourceGeneratesDesignTimeSource

      Obligatoire.Required. Indique si les types des fichiers générés par cet outil personnalisé sont rendus disponibles aux concepteurs visuels.Indicates whether types from files produced by this custom tool are made available to visual designers. La valeur de ce paramètre doit être (zéro) 0 pour les types non disponibles aux concepteurs visuels ou 1 (un) pour les types disponibles aux concepteurs visuels.The value of this parameter needs to be (zero) 0 for types not available to visual designers or (one) 1 for types available to visual designers.

    Note

    Vous devez inscrire l’outil personnalisé séparément pour chaque langue pour laquelle vous voulez que l’outil personnalisé soit disponible.You must register the custom tool separately for each language for which you want the custom tool to be available.

    Par exemple, le MSDataSetGenerator s’inscrit lui-même une seule fois pour chaque langue :For example, the MSDataSetGenerator registers itself once for each language:

    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\14.0\Generators\{164b10b9-b200-11d0-8c61-00a0c91e29d5}\MSDataSetGenerator]  
    @="Microsoft VB Code Generator for XSD"  
    "CLSID"="{E76D53CC-3D4F-40a2-BD4D-4F3419755476}"  
    "GeneratesDesignTimeSource"=dword:00000001  
    
    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\14.0\Generators\{fae04ec1-301f-11d3-bf4b-00c04f79efbc}\MSDataSetGenerator]  
    @="Microsoft C# Code Generator for XSD"  
    "CLSID"="{E76D53CC-3D4F-40a2-BD4D-4F3419755476}"  
    "GeneratesDesignTimeSource"=dword:00000001  
    

Voir aussiSee Also

IVsSingleFileGenerator
Implémentation de générateurs de fichier unique Implementing Single-File Generators
Exposition des Types aux concepteurs visuels Exposing Types to Visual Designers
Introduction à l’objet BuildManagerIntroduction to the BuildManager Object