EntityConnection Classe

Definição

Namespace:

System.Data.EntityClient

Assembly:

System.Data.Entity.dll

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 no 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 instância EntityConnection é construída por meio do construtor sem parâmetros ou por meio do construtor EntityConnection(String), que aceita um 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 e um MetadataWorkspaceDbConnection. Nesse caso, os metadados estão bloqueados no momento da construção. Nenhuma alteração no cadeia de conexão é permitida.

Quando os metadados são carregados, verifica EntityConnection 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

Nome	Description
EntityConnection()	Inicializa uma nova instância da classe EntityConnection.
EntityConnection(MetadataWorkspace, DbConnection)	Inicializa uma nova instância da classe EntityConnection com um MetadataWorkspace e DbConnectionespecificados.
EntityConnection(String)	Inicializa uma nova instância da classe EntityConnection, com base no cadeia de conexão.

Propriedades

Nome	Description
CanRaiseEvents	Obtém um valor que indica se o componente pode gerar um evento. (Herdado de Component)
ConnectionString	Obtém ou define o EntityConnection cadeia de conexão.
ConnectionTimeout	Obtém o número de segundos a aguardar 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 que será usado após a abertura de uma conexão.
DataSource	Obtém o nome ou o endereço de rede da fonte de dados à qual se conectar.
DbProviderFactory	Obtém o DbProviderFactory para isso 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 anexados a isso 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 ConnectionState propriedade do provedor subjacente se ela EntityConnection estiver aberta. Caso contrário, retorna Closed.
StoreConnection	Fornece acesso à conexão de fonte de dados subjacente que é usada pelo EntityConnection objeto.

Métodos

Nome	Description
BeginDbTransaction(IsolationLevel)	Quando substituído em uma classe derivada, inicia 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.
ChangeDatabase(String)	Sem suporte.
Close()	Fecha a conexão com o banco de dados.
CreateCommand()	Cria uma nova instância de um EntityCommand, com o Connection conjunto para isso EntityConnection.
CreateDbCommand()	Quando substituído em uma classe derivada, cria e retorna um DbCommand objeto 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)
EnlistTransaction(Transaction)	Insscrevendo-o 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()	Recupera o objeto de serviço de tempo de vida atual que controla a política de tempo de vida para essa 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, String[])	Retorna informações de esquema para a fonte de dados disso 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)
GetSchema(String)	Retorna informações de esquema para a fonte de dados disso DbConnection usando a cadeia de caracteres especificada para o nome do esquema. (Herdado de DbConnection)
GetService(Type)	Retorna um objeto que representa um serviço fornecido pelo Component ou por sua Container. (Herdado de Component)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida dessa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto atual MarshalByRefObject . (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 do provedor de Open dados subjacente.
OpenAsync()	Uma versão assíncrona de , que abre uma conexão de banco de Open()dados com as configurações especificadas pelo ConnectionString. Esse método invoca o método OpenAsync(CancellationToken) virtual com CancellationToken.None. (Herdado de DbConnection)
OpenAsync(CancellationToken)	Esta é a versão assíncrona de Open(). Os provedores devem substituir com uma implementação apropriada. Opcionalmente, o token de cancelamento pode ser respeitado. A implementação padrão invoca a chamada síncrona Open() e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se aprovada um cancelamento já canceladoToken. As exceções geradas pelo Open serão comunicadas por meio da propriedade de Exceção de Tarefa retornada. Não invoque outros métodos e propriedades do DbConnection objeto até que a Tarefa retornada seja 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

Nome	Description
Disposed	Ocorre quando o componente é descartado por uma chamada para o Dispose() método. (Herdado de Component)
StateChange	Ocorre quando o estado da conexão é alterado. (Herdado de DbConnection)

Implantações explícitas de interface

Nome	Description
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 DbCommand objeto associado à conexão atual. (Herdado de DbConnection)

Confira também

• EntityClient Provider for Entity Framework
• String de Conexão