EntityConnection Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Contém uma referência a um modelo conceitual e uma conexão de fonte de dados. Essa classe não pode ser herdada.
public ref class EntityConnection sealed : System::Data::Common::DbConnectionpublic sealed class EntityConnection : System.Data.Common.DbConnectiontype EntityConnection = class
inherit DbConnectionPublic NotInheritable Class EntityConnection
Inherits DbConnection- Herança
Comentários
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. Chamar Open ou GetMetadataWorkspace bloquear 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.
Para obter exemplos de código, consulte Trabalhando com EntityClient.
Construtores
| EntityConnection() |
Inicializa uma nova instância da classe EntityConnection. |
| EntityConnection(MetadataWorkspace, DbConnection) |
Inicializa uma nova instância da classe EntityConnection com o MetadataWorkspace e o DbConnection especificados. |
| EntityConnection(String) |
Inicializa uma nova instância da classe EntityConnection com base na cadeia de conexão. |
Propriedades
| CanCreateBatch |
Obtém um valor que indica se esta instância DbConnection é compatível com a classe DbBatch. (Herdado de DbConnection) |
| CanRaiseEvents |
Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component) |
| ConnectionString |
Obtém ou define a cadeia de conexão EntityConnection. |
| ConnectionTimeout |
Obtém o número de segundos de espera ao tentar estabelecer uma conexão antes de encerrar a tentativa e gerar um erro. |
| Container |
Obtém o IContainer que contém o Component. (Herdado de Component) |
| Database |
Obtém o nome do banco de dados atual ou o banco de dados a ser usado após uma conexão ser aberta. |
| DataSource |
Obtém o nome do endereço de rede da fonte de dados à qual se conectar. |
| DbProviderFactory |
Obtém o DbProviderFactory para este DbConnection. (Herdado de DbConnection) |
| DesignMode |
Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component) |
| Events |
Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component) |
| ServerVersion |
Obtém uma cadeia de caracteres que contém a versão da fonte de dados à qual o cliente está conectado. |
| Site |
Obtém ou define o ISite do Component. (Herdado de Component) |
| State |
Obtém a propriedade ConnectionState do provedor subjacente se o EntityConnection estiver aberto. Caso contrário, retorna Closed. |
| StoreConnection |
Fornece acesso à conexão da fonte de dados subjacente que é usada pelo objeto EntityConnection. |
Métodos
| BeginDbTransaction(IsolationLevel) |
Quando substituído em uma classe derivada, inicia uma transação de banco de dados. (Herdado de DbConnection) |
| BeginDbTransactionAsync(IsolationLevel, CancellationToken) |
Inicia de maneira assíncrona uma transação de banco de dados. (Herdado de DbConnection) |
| BeginTransaction() |
Inicia uma transação usando o provedor subjacente. |
| BeginTransaction(IsolationLevel) |
Inicia uma transação com o nível de isolamento especificado, usando o provedor subjacente. |
| BeginTransactionAsync(CancellationToken) |
Inicia de maneira assíncrona uma transação de banco de dados. (Herdado de DbConnection) |
| BeginTransactionAsync(IsolationLevel, CancellationToken) |
Inicia de maneira assíncrona uma transação de banco de dados. (Herdado de DbConnection) |
| ChangeDatabase(String) |
Não há suporte. |
| ChangeDatabaseAsync(String, CancellationToken) |
Troca de forma assíncrona o banco de dados atual por uma conexão aberta. (Herdado de DbConnection) |
| Close() |
Fecha a conexão com o banco de dados. |
| CloseAsync() |
Fecha de maneira assíncrona a conexão com o banco de dados. (Herdado de DbConnection) |
| CreateBatch() |
Retorna uma nova instância da classe do provedor que implementa a classe DbBatch . (Herdado de DbConnection) |
| CreateCommand() |
Cria uma nova instância de um EntityCommand, com o Connection definido para esse EntityConnection. |
| CreateDbBatch() |
Quando substituído em uma classe derivada, retorna uma nova instância da classe do provedor que implementa a DbBatch classe . (Herdado de DbConnection) |
| CreateDbCommand() |
Quando substituído em uma classe derivada, cria e retorna um objeto DbCommand associado à conexão atual. (Herdado de DbConnection) |
| CreateObjRef(Type) |
Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
| Dispose() |
Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. (Herdado de DbConnection) |
| Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo DbConnection e opcionalmente libera os recursos gerenciados. (Herdado de DbConnection) |
| DisposeAsync() |
Descarta de forma assíncrona o objeto da conexão. (Herdado de DbConnection) |
| EnlistTransaction(Transaction) |
Inscreve este EntityConnection na transação especificada. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetLifetimeService() |
Obsoleto.
Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject) |
| GetMetadataWorkspace() |
Retorna o MetadataWorkspace associado a este EntityConnection. |
| GetSchema() |
Retorna informações de esquema para a fonte de dados deste DbConnection. (Herdado de DbConnection) |
| GetSchema(String) |
Retorna informações de esquema para a fonte de dados deste DbConnection usando a cadeia de caracteres especificada para o nome do esquema. (Herdado de DbConnection) |
| GetSchema(String, String[]) |
Retorna informações de esquema para a fonte de dados desse DbConnection usando a cadeia de caracteres especificada para o nome do esquema e a matriz de cadeia de caracteres especificada para os valores de restrição. (Herdado de DbConnection) |
| GetSchemaAsync(CancellationToken) |
Essa é uma versão assíncrona de GetSchema().
Provedores devem substituir com uma implementação apropriada.
Opcionalmente, o |
| GetSchemaAsync(String, CancellationToken) |
Essa é a versão assíncrona de GetSchema(String).
Provedores devem substituir com uma implementação apropriada.
Opcionalmente, o |
| GetSchemaAsync(String, String[], CancellationToken) |
Essa é a versão assíncrona de GetSchema(String, String[]).
Provedores devem substituir com uma implementação apropriada.
Opcionalmente, o |
| GetService(Type) |
Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| InitializeLifetimeService() |
Obsoleto.
Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject) |
| OnStateChange(StateChangeEventArgs) |
Aciona o evento StateChange. (Herdado de DbConnection) |
| Open() |
Estabelece uma conexão com a fonte de dados chamando o método |
| OpenAsync() |
Uma versão assíncrona de Open(), que abre uma conexão de banco de dados com as configurações especificadas pelo ConnectionString. Esse método invoca o método virtual OpenAsync(CancellationToken) com CancellationToken.None. (Herdado de DbConnection) |
| OpenAsync(CancellationToken) |
Essa é a versão assíncrona de Open(). Provedores devem substituir com uma implementação apropriada. Opcionalmente, o token de cancelamento pode ser respeitado. A implementação padrão invoca a chamada Open() síncrona e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se já tiver passado um cancellationToken cancelado. Exceções geradas por Open serão comunicadas por meio da propriedade Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do objeto |
| ToString() |
Retorna um String que contém o nome do Component, se houver. Esse método não deve ser substituído. (Herdado de Component) |
Eventos
| Disposed |
Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component) |
| StateChange |
Ocorre quando o estado da conexão é alterado. (Herdado de DbConnection) |
Implantações explícitas de interface
| IDbConnection.BeginTransaction() |
Inicia uma transação de banco de dados. (Herdado de DbConnection) |
| IDbConnection.BeginTransaction(IsolationLevel) |
Inicia uma transação de banco de dados com o nível de isolamento especificado. (Herdado de DbConnection) |
| IDbConnection.CreateCommand() |
Cria e retorna um objeto DbCommand associado à conexão atual. (Herdado de DbConnection) |
