Comment : créer des générateurs de données personnalisés

Les générateurs de données personnalisés sont des composants que la fonctionnalité Générateur de données utilise pour générer des données dans les plans de génération de données. Bien que la fonctionnalité Générateur de données fournisse plusieurs générateurs prédéfinis, vous pouvez créer des générateurs personnalisés adaptés à vos besoins particuliers.

Cette rubrique décrit comment créer un générateur de données personnalisé à l'aide de l'extensibilité classique. L'extensibilité classique est la méthode recommandée à utiliser la plupart du temps. Vous pouvez également utiliser d'autres méthodes pour créer des générateurs de données personnalisés, notamment l'extensibilité déclarative, l'extensibilité d'agrégation et l'extensibilité de base. Pour plus d'informations, consultez Vue d'ensemble de l'extensibilité des générateurs de données.

Pour créer un générateur de données personnalisé

1. Créez un projet Bibliothèque de classes.

2. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le projet, puis cliquez sur Ajouter une référence.

   La boîte de dialogue Ajouter une référence s'affiche.

3. Cliquez sur l'onglet .NET. Dans la liste Nom du composant, cliquez sur Microsoft.Data.Schema, puis sur OK.

4. (Facultatif, Visual Basic uniquement) Dans l'Explorateur de solutions, cliquez sur le bouton Afficher tous les fichiers, puis développez le nœud Références pour vérifier la nouvelle référence.

5. En haut de la fenêtre Code, avant la déclaration de classe, ajoutez la ligne de code suivante :

   Microsoft.Data.Schema.Tools.DataGenerator
   

   Microsoft.Data.Schema.Tools.DataGenerator;
   

6. Renommez la classe Class1 avec le nom que vous voulez.

   Avertissement

   Par défaut, le nom que vous donnez à votre classe est le nom qui s'affichera dans la liste dans la colonne Générateur située dans la fenêtre Détails de la colonne. Vous devez spécifier un nom qui n'est pas en conflit avec le nom d'un générateur standard ou le nom d'un autre générateur personnalisé. Pour plus d'informations, consultez Considérations sur les générateurs de données personnalisés.

   Public Class YourGeneratorName
   
   End Class
   

   public class YourGeneratorName
   {
   }
   

7. Spécifiez que votre classe hérite de Generator, comme illustré dans l'exemple suivant :

   Public Class YourGeneratorName
       Inherits Generator
   
   End Class
   

   public class YourGeneratorName: Generator
   {
   }
   

8. (Facultatif) Ajoutez GeneratorStylesAttribute à la déclaration de classe.

   Important

   Si vous voulez que votre générateur de données personnalisé soit le générateur de données par défaut pour un type de colonne, il doit produire des valeurs uniques, et vous devez ajouter GeneratorStylesAttribute à la classe. Pour plus d'informations, consultez Comment : modifier le générateur par défaut pour un type de colonne.

   <GeneratorStyles(DesignerStyles:=GeneratorDesignerStyles.CanProduceUniqueValues)> _
   Public Class TestGenerator
       Inherits Generator
   
   End Class
   

   [GeneratorStyles(DesignerStyles = GeneratorDesignerStyles.CanProduceUniqueValues)]
   public class TestGenerator:Generator
   {
   }
   

9. (Facultatif) Ajoutez GeneratorAttribute à la déclaration de classe.

   Avertissement

   Ajoutez cet attribut à la déclaration de classe uniquement si vous voulez spécifier un type de concepteur personnalisé pour votre générateur de données personnalisé. Si vous ne souhaitez pas spécifier un type de concepteur personnalisé, omettez cet attribut, et le concepteur par défaut sera utilisé automatiquement.

   <Generator(GetType(CustomDesignerType))> _
   Public Class TestGenerator
       Inherits Generator
   
   End Class
   

   [Generator(typeof(CustomDesignerType))]
   public class TestGenerator:Generator
   {
   }
   

10. Ajoutez au moins une propriété de sortie. Pour plus d'informations, consultez Comment : ajouter des propriétés de sortie un générateur de données.

11. Si nécessaire, ajoutez des propriétés d'entrée. Pour plus d'informations, consultez Comment : ajouter des propriétés d'entrée à un générateur de données.

12. Implémentez la méthode OnGenerateNextValues pour générer des valeurs appropriées pour chaque propriété de sortie. Pour plus d'informations, consultez Procédure pas à pas : création d'un générateur de données personnalisé.

13. Signez l'assembly avec un nom fort. Pour plus d'informations, consultez Procédure pas à pas : création d'un générateur de données personnalisé.

14. Générez la solution.

15. Enregistrez le nouveau générateur avec Visual Studio. Pour plus d'informations, consultez Comment : inscrire et gérer des extensions de fonctionnalité et Procédure pas à pas : création d'un générateur de données personnalisé.

Voir aussi

Tâches

Procédure pas à pas : création d'un générateur de données personnalisé

Concepts

Générer des données de test spécialisées à l'aide d'un générateur de données personnalisé