EntityConnection Constructeurs
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Initialise une nouvelle instance de la classe EntityConnection.
Surcharges
| EntityConnection() |
Initialise une nouvelle instance de la classe EntityConnection. |
| EntityConnection(String) |
Initialise une nouvelle instance de la classe EntityConnection, selon la chaîne de connexion. |
| EntityConnection(MetadataWorkspace, DbConnection) |
Initialise une nouvelle instance de la classe EntityConnection avec un MetadataWorkspace et un DbConnection spécifiés. |
Remarques
Pour éviter la désynchronisation par inadvertance d’objets tels que System.Data.Common.CommandTrees et ObjectContext avec leurs métadonnées, EntityConnection doit verrouiller ses métadonnées. Le verrouillage des métadonnées interdit toute modification de la chaîne de connexion. Deux situations dans lesquelles les métadonnées sont verrouillées sont présentées ci-dessous :
L’instance EntityConnection est construite via le constructeur sans paramètre ou via le EntityConnection(String) constructeur, qui accepte une chaîne de connexion. Dans les deux cas, la chaîne de connexion peut être modifiée plus fois avant l'ouverture de la connexion. L'appel à Open ou GetMetadataWorkspace verrouille les métadonnées.
L'instance EntityConnection est créée par l'intermédiaire du constructeur EntityConnection(MetadataWorkspace, DbConnection), qui accepte un MetadataWorkspace et un DbConnection. Dans ce cas, les métadonnées sont verrouillées lors de la construction. Aucune modification de la chaîne de connexion ne peut plus être effectuée.
Lors du chargement des métadonnées, EntityConnection vérifie que le modèle conceptuel, le modèle de stockage et le fichier de mappage sont tous présents.
Pour obtenir des exemples de code, consultez Utilisation d’EntityClient.
EntityConnection()
Initialise une nouvelle instance de la classe EntityConnection.
public:
EntityConnection();public EntityConnection ();Public Sub New ()Remarques
Pour éviter la désynchronisation par inadvertance d’objets tels que System.Data.Common.CommandTrees et ObjectContext avec leurs métadonnées, EntityConnection doit verrouiller ses métadonnées. Le verrouillage des métadonnées interdit toute modification de la chaîne de connexion. Deux situations dans lesquelles les métadonnées sont verrouillées sont présentées ci-dessous :
L’instance EntityConnection est construite via le constructeur sans paramètre ou via le EntityConnection(String) constructeur, qui accepte une chaîne de connexion. Dans les deux cas, la chaîne de connexion peut être modifiée plus fois avant l'ouverture de la connexion. L'appel à Open ou GetMetadataWorkspace verrouille les métadonnées.
L'instance EntityConnection est créée par l'intermédiaire du constructeur EntityConnection(MetadataWorkspace, DbConnection), qui accepte un MetadataWorkspace et un DbConnection. Dans ce cas, les métadonnées sont verrouillées lors de la construction. Aucune modification de la chaîne de connexion ne peut plus être effectuée.
Lors du chargement des métadonnées, EntityConnection vérifie que le modèle conceptuel, le modèle de stockage et le fichier de mappage sont tous présents.
Pour obtenir des exemples de code, consultez Utilisation d’EntityClient.
S’applique à
EntityConnection(String)
Initialise une nouvelle instance de la classe EntityConnection, selon la chaîne de connexion.
public:
EntityConnection(System::String ^ connectionString);public EntityConnection (string connectionString);new System.Data.EntityClient.EntityConnection : string -> System.Data.EntityClient.EntityConnectionPublic Sub New (connectionString As String)Paramètres
- connectionString
- String
Chaîne de connexion spécifique au fournisseur.
Exceptions
Un mot clé de chaîne de connexion non valide a été fourni ou un mot clé de chaîne de connexion obligatoire n'a pas été fourni.
Remarques
Les outils Entity Data Model génèrent une chaîne de connexion nommée stockée dans le fichier de configuration de l’application. Cette chaîne de connexion nommée peut être fournie à la place du connectionString paramètre lorsque vous instanciez la EntityConnection classe.
Pour éviter la désynchronisation par inadvertance d’objets tels que System.Data.Common.CommandTrees et ObjectContext avec leurs métadonnées, EntityConnection doit verrouiller ses métadonnées. Le verrouillage des métadonnées interdit toute modification de la chaîne de connexion. Deux situations dans lesquelles les métadonnées sont verrouillées sont présentées ci-dessous :
L’instance EntityConnection est construite par le biais du constructeur sans paramètre ou de ce constructeur (EntityConnection(String)), qui accepte une chaîne de connexion. Dans les deux cas, la chaîne de connexion peut être modifiée plus fois avant l'ouverture de la connexion. L'appel à Open ou GetMetadataWorkspace verrouille les métadonnées.
L'instance EntityConnection est créée par l'intermédiaire du constructeur EntityConnection(MetadataWorkspace, DbConnection), qui accepte un MetadataWorkspace et un DbConnection. Dans ce cas, les métadonnées sont verrouillées lors de la construction. Aucune modification de la chaîne de connexion ne peut plus être effectuée.
Lors du chargement des métadonnées, EntityConnection vérifie que le modèle conceptuel, le modèle de stockage et le fichier de mappage sont tous présents.
Pour obtenir des exemples de code, consultez Utilisation d’EntityClient.
S’applique à
EntityConnection(MetadataWorkspace, DbConnection)
Initialise une nouvelle instance de la classe EntityConnection avec un MetadataWorkspace et un DbConnection spécifiés.
public:
EntityConnection(System::Data::Metadata::Edm::MetadataWorkspace ^ workspace, System::Data::Common::DbConnection ^ connection);public EntityConnection (System.Data.Metadata.Edm.MetadataWorkspace workspace, System.Data.Common.DbConnection connection);new System.Data.EntityClient.EntityConnection : System.Data.Metadata.Edm.MetadataWorkspace * System.Data.Common.DbConnection -> System.Data.EntityClient.EntityConnectionPublic Sub New (workspace As MetadataWorkspace, connection As DbConnection)Paramètres
- workspace
- MetadataWorkspace
MetadataWorkspace à associer à ce EntityConnection.
- connection
- DbConnection
Connexion à la source de données sous-jacente pour cet objet EntityConnection.
Exceptions
Le paramètre workspace ou connection est null.
Le modèle conceptuel est absent de l'espace de travail.
- ou -
Le fichier de mappage est absent de l'espace de travail.
- ou -
Le modèle de stockage est absent de l'espace de travail.
- ou -
L'état de connection n'est pas fermé.
connection ne provient pas d'un fournisseur compatible avec ADO.NET Entity Framework.
Remarques
Ce constructeur vous permet de créer un EntityConnection à partir de métadonnées qui ne proviennent pas d'un fichier résidant sur un disque ni d'une ressource incorporée dans un assembly.
Pour éviter la désynchronisation par inadvertance d'objets tels que System.Data.Common.CommandTrees et ObjectContext avec leurs métadonnées, EntityConnection doit verrouiller ses métadonnées. Le verrouillage des métadonnées interdit toute modification de la chaîne de connexion. Deux situations dans lesquelles les métadonnées sont verrouillées sont présentées ci-dessous :
L’instance EntityConnection est construite via le constructeur sans paramètre ou via le EntityConnection(String) constructeur, qui accepte une chaîne de connexion. Dans les deux cas, la chaîne de connexion peut être modifiée plus fois avant l'ouverture de la connexion. L'appel à Open ou GetMetadataWorkspace verrouille les métadonnées.
L'instance EntityConnection est créée par l'intermédiaire de ce constructeur (EntityConnection(MetadataWorkspace, DbConnection)), qui accepte un MetadataWorkspace et un DbConnection. Dans ce cas, les métadonnées sont verrouillées lors de la construction. Aucune modification de la chaîne de connexion ne peut plus être effectuée.
Lors du chargement des métadonnées, EntityConnection vérifie que le modèle conceptuel, le modèle de stockage et le fichier de mappage sont tous présents.
