EntityConnection Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Contém uma referência a um modelo conceptual e uma ligação de fonte de dados. Esta 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
Observações
Para evitar colocar inadvertidamente objetos como System.Data.Common.CommandTrees e ObjectContext fora de sincronia com os seus metadados, EntityConnection deve bloquear os seus metadados. Não são permitidas alterações à cadeia de ligação após o bloqueio dos metadados. Seguem-se dois cenários em que os metadados estão bloqueados:
A instância EntityConnection é construída através do construtor sem parâmetros, ou através do construtor EntityConnection(String), que aceita um cadeia de ligação. Em qualquer dos casos, a cadeia de ligação pode ser alterada várias vezes antes de a ligação ser aberta. A chamada Open ou GetMetadataWorkspace bloqueia os metadados.
A EntityConnection instância é construída através do EntityConnection(MetadataWorkspace, DbConnection) construtor, que aceita a MetadataWorkspace e um DbConnection. Neste caso, os metadados são bloqueados no momento da construção. Nunca são permitidas alterações à cadeia de ligação.
Quando os metadados são carregados, verifica-se EntityConnection que o modelo conceptual, o modelo de armazenamento e o ficheiro de mapeamento estão todos presentes.
Para exemplos de código, veja Trabalhar com EntityClient.
Construtores
| Name | Description |
|---|---|
| EntityConnection() |
Inicializa uma nova instância da EntityConnection classe. |
| EntityConnection(MetadataWorkspace, DbConnection) |
Inicializa uma nova instância da EntityConnection classe com um especificado MetadataWorkspace e DbConnection. |
| EntityConnection(String) |
Inicializa uma nova instância da classe EntityConnection, com base na cadeia de ligação. |
Propriedades
| Name | 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 ligação. |
| ConnectionTimeout |
Obtém o número de segundos de espera ao tentar estabelecer uma ligação antes de terminar a tentativa e gerar um erro. |
| Container |
Obtém o IContainer que contém o Component. (Herdado de Component) |
| Database |
Recebe o nome da base de dados atual, ou a base de dados que será usada após a abertura de uma ligação. |
| DataSource |
Obtém o nome ou endereço de rede da fonte de dados a que se deve ligar. |
| DbProviderFactory |
Recebe o DbProviderFactory por isto DbConnection. (Herdado de DbConnection) |
| DesignMode |
Obtém um valor que indica se o Component está atualmente em modo de design. (Herdado de Component) |
| Events |
Obtém a lista de gestores de eventos que estão ligados a isto Component. (Herdado de Component) |
| ServerVersion |
Obtém uma string que contém a versão da fonte de dados à qual o cliente está ligado. |
| Site |
Obtém ou define o ISite do Component. (Herdado de Component) |
| State |
Obtém a ConnectionState propriedade do fornecedor subjacente se o EntityConnection estiver aberto. Caso contrário, retorna Closed. |
| StoreConnection |
Fornece acesso à ligação da fonte de dados subjacente que é usada pelo EntityConnection objeto. |
Métodos
| Name | Description |
|---|---|
| BeginDbTransaction(IsolationLevel) |
Quando é sobreposto numa classe derivada, inicia uma transação de base de dados. (Herdado de DbConnection) |
| BeginTransaction() |
Inicia uma transação utilizando o fornecedor subjacente. |
| BeginTransaction(IsolationLevel) |
Inicia uma transação com o nível de isolamento especificado utilizando o fornecedor subjacente. |
| ChangeDatabase(String) |
Não suportado. |
| Close() |
Fecha a ligação à base de dados. |
| CreateCommand() |
Cria uma nova instância de um EntityCommand, com o Connection conjunto para este EntityConnection. |
| CreateDbCommand() |
Quando sobreposto numa classe derivada, cria e devolve um DbCommand objeto associado à ligação atual. (Herdado de DbConnection) |
| CreateObjRef(Type) |
Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
| EnlistTransaction(Transaction) |
Inclui isto EntityConnection na transação especificada. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetLifetimeService() |
Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject) |
| GetMetadataWorkspace() |
Devolve o MetadataWorkspace associado a este EntityConnection. |
| GetSchema() |
Devolve informação de esquema para a fonte de dados deste DbConnection. (Herdado de DbConnection) |
| GetSchema(String, String[]) |
Devolve a informação do esquema para a fonte de dados desta DbConnection usando a cadeia especificada para o nome do esquema e o array de cadeias especificado para os valores de restrição. (Herdado de DbConnection) |
| GetSchema(String) |
Devolve a informação do esquema para a fonte de dados desta DbConnection usando a cadeia especificada para o nome do esquema. (Herdado de DbConnection) |
| GetService(Type) |
Devolve 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() |
Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| OnStateChange(StateChangeEventArgs) |
Eleva o StateChange evento. (Herdado de DbConnection) |
| Open() |
Estabelece uma ligação à fonte de dados ao chamar o método do |
| OpenAsync() |
Uma versão assíncrona de Open(), que abre uma ligação à base de dados com as definições especificadas pelo ConnectionString. Este 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 prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode ser opcionalmente aceito. A implementação padrão invoca a chamada síncrona Open() e devolve uma tarefa concluída. A implementação padrão devolverá uma tarefa cancelada se for passada uma cancellationToken já cancelada. As exceções lançadas pelo Open serão comunicadas através da propriedade de Exceção de Tarefa devolvida. Não invoque outros métodos e propriedades do |
| ToString() |
Devolve a String contendo o nome do Component, se existir. Este método não deve ser ultrapassado. (Herdado de Component) |
evento
| Name | Description |
|---|---|
| Disposed |
Ocorre quando o componente é eliminado por uma chamada ao Dispose() método. (Herdado de Component) |
| StateChange |
Ocorre quando o estado da ligação muda. (Herdado de DbConnection) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| IDbConnection.BeginTransaction() |
Inicia uma transação de base de dados. (Herdado de DbConnection) |
| IDbConnection.BeginTransaction(IsolationLevel) |
Inicia uma transação de base de dados com o nível de isolamento especificado. (Herdado de DbConnection) |
| IDbConnection.CreateCommand() |
Cria e devolve um DbCommand objeto associado à ligação atual. (Herdado de DbConnection) |