Partager via

Page de propriétés (Contrôle EntityDataSource)

  • Article

Mise à jour : novembre 2007

Le contrôle ASP.NET EntityDataSourcePage de propriétés s'affiche dans l'IDE de Visual Studio lorsque le contrôle DTC est sélectionné sur l'aire de conception de page Web. La Page de propriétés permet de définir des valeurs, même si elles ne semblent pas correctes dans une vue spécifique des métadonnées.

Remarque :

Contrairement aux données affichées dans l'Assistant Configurer la source de données, sur la Page de propriétés, la sélection d'une propriété liée à d'autres propriétés ne met pas automatiquement à jour les propriétés connexes avec des valeurs valides. Dans l'Assistant Configurer la source de données, si vous sélectionnez un EntityContainer dans la liste déroulante DefaultContainerName, la liste des jeux d'entités disponibles dans la liste déroulante EntitySetName est remplie automatiquement avec les jeux d'entités valides pour ce conteneur et toute valeur précédente d'EntitySetName est effacée. L'Assistant fournit une vue restrictive de la configuration

Bien que les valeurs de propriété pour les propriétés dépendantes ne soient pas alignées automatiquement par la Page de propriétés, les valeurs disponibles dans la liste déroulante pour une propriété spécifiée peuvent être basées sur d'autres valeurs. Par exemple, si le ContainerName actuel est reconnu, le développement de la liste déroulante pour EntitySetName affiche une liste de jeux d'entités valides pour ce ContainerName.

L'illustration suivante montre la Page de propriétés avec des assignations de propriété.

La liste suivante décrit le comportement pour les propriétés du contrôle EntityDataSource.

  • Toutes les propriétés dans le groupe de comportements sont booléennes et autorisent uniquement les valeurs de liste déroulante « true » et « false ».

  • ConnectionString est une chaîne simple. La validité de la chaîne est déterminée au moment de l'exécution.

  • DefaultContainerName est une liste déroulante du même jeu de conteneurs d'entités que celui décrit dans l'Assistant plus haut dans cette rubrique. L'utilisateur peut également entrer un nom de conteneur qui n'est pas dans la liste. Les noms non valides sont détectés au moment de l'exécution.

  • EntitySetName est une liste déroulante des jeux d'entités pour le nom de conteneur sélectionné. Cette propriété peut être vide si le nom de conteneur n'est pas trouvé dans les métadonnées détectables. L'utilisateur peut entrer un EntitySetName qui n'est pas dans la liste. Les noms non valides sont détectés au moment de l'exécution.

  • GroupBy est une chaîne simple qui n'a pas de paramètres.

  • OrderBy, Where, Select et CommandText sont composés de deux parties :

    • une chaîne contenant le texte de l'expression ;

    • les paramètres utilisés dans ces expressions. La Page de propriétés affiche uniquement la chaîne. Les paramètres ne sont pas visibles à moins de cliquer à nouveau sur les ellipses du générateur ou d'afficher le balisage directement. Pour plus d'informations sur les boîtes de dialogue du générateur pour ces propriétés, consultez les boîtes de dialogue OrderBy, Select, Where et CommandText dans Éditeur d'expressions (Contrôle EntityDataSource).

  • EntityTypeFilter est une liste déroulante du même jeu de types affiché dans l'Assistant Configurer la source de données si la propriété EntitySetName n'est pas vide et est reconnue dans les métadonnées. L'utilisateur peut entrer une valeur qui n'est pas dans la liste. Les noms non valides sont détectés au moment de l'exécution.

  • ID est l'identificateur du contrôle dans le balisage de la page.

Page Événements

La page Événements affiche les événements publics du contrôle EntityDataSource. Visual Studio comprend une liste déroulante qui affiche toutes les méthodes qui correspondent à la signature adéquate pour le gestionnaire de chaque événement. L'utilisateur peut double-cliquer sur la valeur de propriété pour ajouter une nouvelle méthode ou accéder à une méthode existante si elle se trouve déjà dans le code.

L'illustration suivante présente la page des événements du contrôle EntityDataSource.

Voir aussi

Concepts

Élément de boîte à outils (Contrôle EntityDataSource)

Contrôle DTC (Contrôle EntityDataSource)

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