Assistant Configuration de la source de données (Contrôle EntityDataSource)

Article
10/22/2014

Mise à jour : novembre 2007

L'Assistant Configuration de la source de données du contrôle EntityDataSource dans l'infrastructure ASP.NET est un Assistant à deux pages qui permet d'initialiser la source de données. La première page vous permet de sélectionner une connexion nommée à partir du fichier WebConfig ou d'ajouter une chaîne de connexion qui identifie la base de données. Le contenu de la deuxième page diffère selon que vous utilisez une instruction Select configurée par les options sur l'Assistant ou un autre texte de commande de votre propre conception.

Première page de l'Assistant

L'illustration suivante présente la première page de l'Assistant. La Connexion nomméeAdvWksSalesEntities du fichier Web.config du projet est sélectionné dans la liste déroulante. La sélection dans la liste déroulante DefaultContainerName est également AdvWksSalesEntities. La chaîne de connexion dans une implémentation du modèle EDM (Entity Data Model) est, par défaut, identifiée par EntityContainer dans la structure de schéma. Pour plus d'informations sur le type EntityContainer, consultez Entity Data Model. La première page de l'Assistant se présente comme suit :

Pour plus d'informations sur les propriétés du contrôle EntityDataSource qui sont initialisées par la première page de l'Assistant, consultez Configuration du contrôle EntityDataSource.

Deuxième page de l'Assistant

La deuxième page de l'Assistant a deux vues possibles : l'une ou l'autre s'affiche selon qu'une valeur est ou non assignée à la propriété Select.

Vue Select simple de l'Assistant

La vue Select simple de l'Assistant s'affiche lorsque la propriété Select du contrôle EntityDataSource n'est pas assignée ou lorsqu'une liste séparée par des virgules des propriétés d'entité reconnues sous la forme item.[Property1], item.[Property2] est assignée à la propriété Select, avec ou sans les crochets d'échappement. Les propriétés possibles pour DefaultContainerName, EntitySetName et EntityTypeFilter doivent toutes être reconnues comme étant des valeurs valides dans le modèle de données utilisé par l'application.

La vue Select simple de l'Assistant permet de sélectionner EntitySetName, d'entrer un EntityTypeFilter (facultatif) et de définir les propriétés à afficher dans le contrôle de données. EntityTypeFilter n'est nécessaire que lors de l'utilisation de types dérivés dans une hiérarchie d'héritage.

Lorsque l'utilisateur active Sélectionner tout (valeur d'entité), des entités complètes sont retournées au lieu des résultats qui contiennent des propriétés individuelles. Les valeurs d'entité peuvent être mises à jour et permettent également aux contrôles liés aux données d'afficher et de modifier les propriétés de clé des entités associées et des membres de type complexe.

L'illustration suivante présente la vue Select simple pour la deuxième page de l'Assistant.

Vue Select avancée de l'Assistant

La vue Select avancée de l'Assistant, telle qu'elle est présentée ci-dessous, s'affiche lorsque la propriété Select a une valeur autre que les options affichées par la vue simple.

Les cases à cocher Activer les insertions automatiques, Activer les mises à jour automatiques et Activer les suppressions automatiques ont chacune deux valeurs possibles. Pour la page Select simple de l'Assistant, si une option autre que Sélectionner tout est activée dans la liste de propriétés, ces cases à cocher sont désactivées dans la page Select avancée. Pour la vue Select avancée de l'Assistant, ces cases à cocher sont désactivées dès la saisie dans la zone de texte Select, comme le montre l'instruction select personnalisée dans l'illustration.

Remarque :
Comme dans Entity Framework, l'utilisation de Select crée une projection des données. Les projections ne sont pas modifiables. Select ne peut pas être défini si la case à cocher Activer les suppressions automatiques, Activer les insertions automatiques ou Activer les mises à jour automatiques est activée.