EntityConnection.GetMetadataWorkspace Método

Definição

Namespace:

System.Data.EntityClient

Assembly:

System.Data.Entity.dll

Importante

Esta API não está em conformidade com CLS.

Retorna o MetadataWorkspace associado a este 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

Retornos

MetadataWorkspace

O MetadataWorkspace associado a este EntityConnection.

Atributos

CLSCompliantAttribute

Exceções

MetadataException

A cadeia de conexão embutida contém um valor de palavra-chave Metadata inválido.

Comentários

Um MetadataWorkspace é criado automaticamente quando a EntityConnection classe é criada. O processo de criação pode gerar exceções específicas de metadados. Os metadados são carregados na memória e um aplicativo EDM (Modelo de Dados de Entidade) usa esses metadados para acessar informações sobre a fonte de dados subjacente. Para obter mais informações, consulte metadados ADO.NET.

Para evitar inadvertidamente colocar objetos como System.Data.Common.CommandTrees e ObjectContext fora de sincronia com seus metadados, EntityConnection deve bloquear seus metadados. Nenhuma alteração na cadeia de conexão é permitida depois que os metadados são bloqueados. Veja a seguir dois cenários em que os metadados estão bloqueados:

• A EntityConnection instância é construída por meio do construtor sem parâmetros ou por meio do EntityConnection(String) construtor , que aceita uma cadeia de conexão. Em ambos os casos, a cadeia de conexão pode ser alterada várias vezes antes da conexão ser aberta. Open ou GetMetadataWorkspace bloqueia os metadados.

• A EntityConnection instância é construída por meio do EntityConnection(MetadataWorkspace, DbConnection) construtor , que aceita um MetadataWorkspace e um DbConnection. Nesse caso, os metadados são bloqueados no momento da construção. Nenhuma alteração na cadeia de conexão é permitida.

Quando os metadados são carregados, o EntityConnection verifica se o modelo conceitual, o modelo de armazenamento e o arquivo de mapeamento estão todos presentes.