EntityConnection.GetMetadataWorkspace Méthode

Définition

Espace de noms:

System.Data.EntityClient

Assembly:

System.Data.Entity.dll

Important

Cette API n’est pas conforme CLS.

Retourne l'objet MetadataWorkspace associé à cet objet EntityConnection.

public:
 System::Data::Metadata::Edm::MetadataWorkspace ^ GetMetadataWorkspace();

[System.CLSCompliant(false)]
public System.Data.Metadata.Edm.MetadataWorkspace GetMetadataWorkspace ();

[<System.CLSCompliant(false)>]
member this.GetMetadataWorkspace : unit -> System.Data.Metadata.Edm.MetadataWorkspace

Public Function GetMetadataWorkspace () As MetadataWorkspace

Retours

MetadataWorkspace

MetadataWorkspace associé à ce EntityConnection.

Attributs

CLSCompliantAttribute

Exceptions

MetadataException

La chaîne de connexion incluse contient une valeur de mot clé Metadata non valide.

Remarques

MetadataWorkspace est automatiquement créé lorsque la classe EntityConnection est créée. Le processus de création peut lever des exceptions spécifiques aux métadonnées. Les métadonnées sont chargées en mémoire et une application EDM (Entity Data Model) les utilise pour accéder aux informations relatives à la source de données sous-jacente. Pour plus d’informations, consultez métadonnées ADO.NET.

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 :

• La EntityConnection instance est construite par le biais du constructeur sans paramètre ou du EntityConnection(String) constructeur, qui accepte une chaîne de connexion. Dans les deux cas, le chaîne de connexion peut être modifié plusieurs fois avant l’ouverture de la connexion. 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.