Partager via

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

  • Article

Mise à jour : novembre 2007

Les générateurs de données personnalisés sont des composants que le générateur de données peut utiliser pour générer des données dans des plans de génération de données. Bien que le générateur de données fournisse plusieurs générateurs prédéfinis, vous pouvez créer des générateurs personnalisés en fonction de vos besoins particuliers.

Cette rubrique explique comment créer un générateur de données personnalisé en utilisant une extensibilité normale. L'extensibilité normale est la méthode qu'il est recommandé d'utiliser dans la plupart des cas. 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 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 et, dans la liste Nom du composant, cliquez sur Microsoft.VisualStudio.TeamSystem.Data, 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 :

    Imports Microsoft.VisualStudio.TeamSystem.Data.DataGenerator

    using Microsoft.VisualStudio.TeamSystem.Data.DataGenerator;

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

    Attention :

    Par défaut, le nom que vous donnez à votre classe est le nom qui apparaît dans la liste affichée dans la colonne Générateur de la fenêtre Détails de la colonne. Vous devez spécifier un nom qui ne crée pas de conflit avec le nom d'un générateur standard ou 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.

    Remarque importante :

    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.

    Attention :

    Vous devez ajouter GeneratorAttribute à la classe uniquement si vous voulez spécifier un type de concepteur personnalisé pour votre générateur de données personnalisé. Si vous ne voulez pas spécifier un concepteur personnalisé, vous pouvez omettre cet attribut, et le concepteur par défaut est automatiquement utilisé.

    		 
    <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 : enregistrer des générateurs de données personnalisés.

Sécurité

Pour plus d'informations, consultez Sécurité des générateurs de données.

Voir aussi

Autres ressources

Création de générateurs de données personnalisés

Procédures pas à pas du générateur de données