DbModelBuilder, classe

[Cette page concerne Entity Framework version 6. La dernière version est disponible sous le nom de package 'Entity Framework' NuGet. Pour plus d'informations sur Entity Framework, consultez msdn.com/data/ef.]

DbModelBuilder est utilisé pour mapper des classes CLR à un schéma de base de données. Cette approche centrée sur le code pour générer un modèle EDM (Entity Data Model) est appelée Code First.

Hiérarchie d'héritage

System.Object
  System.Data.Entity.DbModelBuilder

Espace de noms :  System.Data.Entity
Assembly :  EntityFramework (dans EntityFramework.dll)

Syntaxe

'Déclaration
Public Class DbModelBuilder
'Utilisation
Dim instance As DbModelBuilder

public class DbModelBuilder

public ref class DbModelBuilder

type DbModelBuilder =  class end

public class DbModelBuilder

Le type DbModelBuilder expose les membres suivants.

Constructeurs

	Nom	Description
	DbModelBuilder()	Initialise une nouvelle instance de la classe DbModelBuilder.Le processus de découverte du modèle initial utilise l'ensemble de conventions inclus dans la dernière version de l'Entity Framework installée sur votre ordinateur.
	DbModelBuilder(DbModelBuilderVersion)	Initialise une nouvelle instance de la classe DbModelBuilder qui utilisera un ensemble spécifique de conventions pour découvrir le modèle initial.

Top

Propriétés

	Nom	Description
	Configurations	Obtient le ConfigurationRegistrar de ce DbModelBuilder.Le registre autorise l'enregistrement d'une entité dérivée et de configurations de type complexe avec ce générateur.
	Conventions	Fournit l'accès aux paramètres de ce DbModelBuilder relatif aux conventions.

Top

Méthodes

	Nom	Description
	Build(DbConnection)	Crée un DbModel selon la configuration créée à l'aide de ce générateur.La connexion est utilisée pour déterminer le fournisseur de bases de données utilisé, car cela affecte la couche de base de données du modèle généré.
	Build(DbProviderInfo)	Crée un DbModel selon la configuration créée à l'aide de ce générateur.Les informations sur le fournisseur de services doivent être spécifiées parce que cela affecte la couche de base de données du modèle généré.Pour SqlClient le nom invariant est « System.Data.SqlClient » et le jeton de manifeste est l'année de version (par exemple,« 2005 », « 2008 », etc.).
	ComplexType<TComplexType>	Enregistre un type en tant que type complexe dans le modèle et retourne un objet qui peut être utilisé pour configurer le type complexe.Cette méthode peut être appelée plusieurs fois pour le même type pour créer plusieurs lignes de configuration.
	Entity<TEntityType>	Enregistre un type d'entité dans le cadre du modèle et retourne un objet qui peut être utilisé pour configurer l'entité.Cette méthode peut être appelée plusieurs fois pour la même entité, pour créer plusieurs lignes de configuration.
	Equals	Spécifie si DbModelBuilder est égal à l'objet spécifié. (Substitue Object.Equals(Object).)
	Finalize	(Hérité de Object.)
	GetHashCode	Retourne le code de hachage pour l'instance actuelle. (Substitue Object.GetHashCode().)
	GetType	Obtient le Type de l'instance actuelle.
	HasDefaultSchema	Configure le nom de schéma de base de données par défaut.Ce nom de schéma de base de données par défaut est utilisé pour les objets de base de données qui n'ont pas de nom de schéma explicite configuré.
	Ignore(IEnumerable<Type>)	Exclut les types spécifiés du modèle.Cela est utilisé pour supprimer des types du modèle, ajoutés par convention pendant la découverte initiale du modèle.
	Ignore<T>()	Exclut un type du modèle.Cela est utilisé pour supprimer des types du modèle, ajoutés par convention pendant la découverte initiale du modèle.
	MemberwiseClone	(Hérité de Object.)
	Properties()	Démarre la configuration d'une convention légère qui s'applique à toutes les propriétés du modèle.
	Properties<T>()	Démarre la configuration d'une convention légère qui s'applique à toutes les propriétés primitives du type spécifié dans le modèle.
	RegisterEntityType	Inscrit un type d'entité dans le cadre du modèle.
	ToString	Retourne une représentation sous forme de chaîne de DbModelBuilder. (Substitue Object.ToString().)
	Types()	Démarre la configuration d'une convention légère qui s'applique à l'ensemble des types d'entités et types complexes du modèle.
	Types<T>()	Démarre la configuration d'une convention légère qui s'applique à l'ensemble des types d'entités et types complexes du modèle qui héritent du type spécifié par l'argument générique ou qui implémentent ce type.Cette méthode ne stocke pas les types dans le modèle.

Top

Notes

DbModelBuilder est généralement utilisé pour configurer un modèle en substituant OnModelCreating(DbModelBuilder). Utilisez également DbModelBuilder indépendamment de DbContext pour générer un modèle, puis construire un DbContext ou un ObjectContext. Toutefois, l'approche recommandée est d'utiliser OnModelCreating dans DbContext, car le flux de travail est plus intuitif et prend soin des tâches courantes, telles que la mise en cache du modèle créé. Les types qui composent votre modèle sont enregistrés avec un DbModelBuilder, et une configuration facultative peut être effectuée en appliquant des annotations de données à vos classes et/ou en utilisant l'API Fluent DbModelBuilder. Lorsque la méthode Build est appelée, un jeu de conventions est exécuté pour découvrir le modèle initial. Ces conventions découvriront automatiquement les aspects du modèle, tels que les clés primaire, et traiteront également toutes les annotations de données spécifiées sur vos classes. Enfin, toute configuration effectuée à l'aide de l'API DbModelBuilder est appliquée. La configuration faite à l'aide de l'API DbModelBuilder est prioritaire sur les annotations de données qui, à leur tour, sont prioritaires sur les conventions par défaut.

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.

Voir aussi

Référence

Espace de noms System.Data.Entity