EntityConnection Classe

Referência

Definição

Namespace:: System.Data.EntityClient

Assembly:: System.Data.Entity.dll

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::DbConnection

public sealed class EntityConnection : System.Data.Common.DbConnection

type EntityConnection = class
    inherit DbConnection

Public NotInheritable Class EntityConnection
Inherits DbConnection

Herança: Object

MarshalByRefObject

Component

DbConnection
EntityConnection

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 `cancellationToken` pode ser respeitado. A implementação padrão invoca a chamada GetSchema() 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 GetSchema() serão comunicadas por meio da propriedade Exceção de Tarefa retornada. (Herdado de DbConnection)
GetSchemaAsync(String, CancellationToken)	Essa é a versão assíncrona de GetSchema(String). Provedores devem substituir com uma implementação apropriada. Opcionalmente, o `cancellationToken` pode ser respeitado. A implementação padrão invoca a chamada GetSchema(String) 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 GetSchema(String) serão comunicadas por meio da propriedade Exceção de Tarefa retornada. (Herdado de DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Essa é a versão assíncrona de GetSchema(String, String[]). Provedores devem substituir com uma implementação apropriada. Opcionalmente, o `cancellationToken` pode ser respeitado. A implementação padrão invoca a chamada GetSchema(String, String[]) 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 GetSchema(String, String[]) serão comunicadas por meio da propriedade Exceção de Tarefa retornada. (Herdado de DbConnection)
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 `Open` do provedor de dados subjacentes.
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 `DbConnection` até a Tarefa retornada ser concluída. (Herdado de DbConnection)
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)

Aplica-se a

Compartilhar via