Procédure : créer et modifier des types complexes (Entity Data Model Tools)
Cette rubrique décrit comment créer et modifier des types complexes avec ADO.NET Entity Data Model Designer(Concepteur d'entités). Pour plus d'informations sur l'utilisation de types complexes, consultez Complex Type Objects (Entity Framework).
Vous pouvez créer et modifier des types complexes dans la fenêtre Explorateur de modèles du Concepteur d'entités. Les procédures suivantes supposent que vous avez ouvert un fichier .edmx dans le Concepteur d'entités et que la fenêtre Explorateur de modèles est visible.
Création d'un type complexe
Vous pouvez créer un type complexe en appliquant l'une des méthodes répertoriées ci-dessous.
Pour créer un type complexe
Dans l'Explorateur de modèles, cliquez avec le bouton droit sur le dossier Types complexes, pointez sur Ajouter, puis cliquez sur Type complexe.
Un nouveau type complexe est ajouté au dossier avec un nom par défaut (pour plus d'informations sur l'affectation d'un nom différent, consultez la section « Affectation d'un autre nom à un type complexe » ci-dessous).
Ajoutez des propriétés au type complexe.
Pour plus d'informations, consultez la section « Ajout de propriétés à un type complexe » ci-dessous.
- OU -
Dans l'Explorateur de modèles, sélectionnez le dossier Types complexes, puis appuyez sur la touche Insertion de votre clavier.
Un nouveau type complexe est ajouté au dossier avec un nom par défaut.
Ajoutez des propriétés au type complexe.
- OU -
Sur l'aire du Concepteur d'entités, sélectionnez une ou plusieurs propriétés (à l'exclusion des propriétés de navigation) d'une entité, puis cliquez avec le bouton droit et sélectionnez Refactoriser en nouveau type complexe.
Un nouveau type complexe avec les propriétés sélectionnées est ajouté à l'Explorateur de modèles. Un nom par défaut est affecté au type complexe.
Une propriété complexe du type récemment créé remplace les propriétés sélectionnées. Tous les mappages de propriété sont conservés.
OU
Ajoutez une importation de fonction à votre modèle conceptuel et cliquez sur Créer un type complexe dans la boîte de dialogue Importation de fonction. Pour plus d'informations, consultez Procédure : importer une procédure stockée (Entity Data Model Tools).
Affectation d'un autre nom à un type complexe
Lorsque vous renommez un type complexe, toutes les références au type sont mises à jour dans tout le projet.
Vous pouvez renommer un type complexe en appliquant l'une des méthodes répertoriées ci-dessous.
Pour renommer un type complexe
Double-cliquez lentement sur un type complexe dans l'Explorateur de modèles.
Le nom est sélectionné et passe en mode édition.
- OU -
Cliquez avec le bouton droit sur un type complexe dans l'Explorateur de modèles, puis sélectionnez Renommer.
Le nom est sélectionné et passe en mode édition.
- OU -
Sélectionnez un type complexe dans l'Explorateur de modèles, puis appuyez sur la touche F2.
Le nom est sélectionné et passe en mode édition.
- OU -
Cliquez avec le bouton droit sur un type complexe dans l'Explorateur de modèles, puis sélectionnez Propriétés. Modifiez le nom dans la fenêtre Propriétés.
Ajout de propriétés à un type complexe
Les propriétés d'un type complexe peuvent être des types scalaires ou des types complexes existants. Toutefois, les propriétés de type complexe ne peuvent pas avoir de références circulaires. Par exemple, un type complexe ContactInfo ne peut pas avoir une propriété de type complexe ContactInfo.
Vous pouvez ajouter une propriété à un type complexe en appliquant l'une des méthodes répertoriées ci-dessous.
Pour ajouter une propriété à un type complexe
Cliquez avec le bouton droit sur un type complexe dans l'Explorateur de modèles, pointez sur Ajouter, sur Propriété scalaire ou sur Propriété complexe, puis sélectionnez le type de propriété désiré.
Une nouvelle propriété est ajoutée au type complexe avec un nom par défaut.
- OU -
Cliquez avec le bouton droit sur une propriété d'entité sur l'aire du Concepteur d'entités, sélectionnez Copier, puis cliquez avec le bouton droit sur le type complexe dans l'Explorateur de modèles et sélectionnez Coller.
- OU -
Sélectionnez un type complexe dans l'Explorateur de modèles, puis appuyez sur la touche Insertion de votre clavier.
Une nouvelle propriété scalaire est ajoutée au type complexe avec un nom par défaut.
Suppression d'un type complexe
Lorsque vous supprimez un type complexe, le type est supprimé du modèle conceptuel, et les mappages pour toutes les instances du type sont supprimés. Toutefois, les références au type ne sont pas mises à jour. Par exemple, si une entité a une propriété de type complexe de type ComplexType1 et que ComplexType1 est supprimé dans l'Explorateur de modèles, la propriété d'entité correspondante n'est pas mise à jour. Le modèle n'est pas validé, car il contient une entité qui référence un type complexe supprimé. Vous pouvez mettre à jour ou supprimer des références à des types complexes supprimés à l'aide du Concepteur d'entités.
Vous pouvez supprimer un type complexe des façons suivantes :
Pour supprimer un type complexe
Cliquez avec le bouton droit sur un type complexe dans l'Explorateur de modèles, puis sélectionnez Supprimer.
- OU -
Sélectionnez un type complexe dans l'Explorateur de modèles, puis appuyez sur la touche Suppr de votre clavier.
Voir aussi
Tâches
Procédure : ajouter une propriété de type complexe à une entité (Entity Data Model Tools)
Procédure : mapper des propriétés de type complexe à des colonnes de table (Entity Data Model Tools)
Procédure : mapper une importation de fonction à un type complexe (Entity Data Model Tools)