Générer le DataSet, boîte de dialogue

Article
08/10/2011

Vous permet d'afficher des options pour générer une classe DataSet typée à partir des informations fournies par un ou plusieurs adaptateurs de données. Cette boîte de dialogue permet d'exécuter les opérations suivantes :

Créer une nouvelle classe typée.
Ajouter des tables à une classe DataSet existante ou modifier les définitions de colonnes d'une table déjà présente dans le groupe de données.

Notes

Pour supprimer une table d'une classe DataSet, modifiez le schéma du groupe de données à l'aide du Concepteur de DataSet. Pour plus d'informations, consultez Concepteur de DataSet.

La classe DataSet typée générée suite à l'utilisation de cette boîte de dialogue est stockée dans votre projet sous la forme de deux fichiers : un fichier .xsd et un fichier de classe correspondant (par exemple .vb) qui incorpore les informations de schéma.

Pour afficher la boîte de dialogue Générer le DataSet, sélectionnez un ou plusieurs adaptateurs de données dans un formulaire ou composant et cliquez ensuite sur la commande Générer le DataSet dans le menu contextuel.

Liste des éléments d'interface utilisateur

Choisir un groupe de données
Indiquez si vous voulez générer une nouvelle classe DataSet ou régénérer une classe DataSet existante. Choisissez l'une des options suivantes :
- Existant Cette option spécifie que vous voulez ajouter ou rajouter une table à une classe DataSet existante. Sélectionnez le groupe de données à mettre à jour dans la liste.
- Nouveau Cette option permet de spécifier un nom pour une nouvelle classe DataSet.
Choisir les tables à ajouter au groupe de données
Spécifie la table ou les tables à ajouter au groupe de données. La liste des tables est dérivée des adaptateurs de données dans le formulaire ou le composant (chaque adaptateur de données accède normalement à une seule table). Les noms des tables à générer sont dérivés de la propriété TableMappings de l'adaptateur ; si aucun mappage de table n'est spécifié, le nom de la table est alors passé à partir de la source de données.

Vérifiez les noms des tables à ajouter (ou rajouter) au groupe de données.

Notes

Si le nom d'une table déjà présente dans le groupe de données est effacé, il n'est pas supprimé du groupe de données. L'effacement du nom signifie seulement qu'il ne sera pas rajouté au groupe de données.

Si vous mettez à jour un groupe de données existant en ajoutant des tables, l'un des événements suivants a lieu :
- Si la table ne se trouvait pas précédemment dans le groupe de données, sa définition est fusionnée dans ce dernier. Toutes les tables, relations et autres structures déjà présentes dans le groupe de données restent intactes.
- Si la table se trouvait précédemment dans le groupe de données, la nouvelle définition de table se substitue à la définition existante. Par exemple, si la nouvelle définition de table inclut moins de colonnes, les colonnes sont réellement supprimées du groupe de données.
Ajouter ce groupe de données au concepteur
Spécifie s'il faut ajouter une instance de ce groupe de données au formulaire actuel. Vous pouvez choisir de ne pas créer d'instance :
- si vous ne souhaitez pas utiliser le groupe de données sur le formulaire en cours (et envisagez plutôt de l'utiliser dans un autre composant) ;
- si vous générez la classe DataSet simplement dans le but de créer un fichier de schéma.
L'instance du groupe de données utilise le nom du groupe de données, suivi d'un numéro séquentiel. Par exemple, si le groupe de données est nommé Dataset1, la première instance est nommée Dataset11, la deuxième instance est nommée Dataset12, et ainsi de suite. Vous pouvez changer le nom d'une instance sur le formulaire ou le composant dans la fenêtre Propriétés.