EntityConnection Classe

Definizione

Spazio dei nomi:

System.Data.EntityClient

Assembly:

System.Data.Entity.dll

Contiene un riferimento a un modello concettuale e a una connessione all'origine dati. Questa classe non può essere ereditata.

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

Ereditarietà

Object

MarshalByRefObject

Component

DbConnection

EntityConnection

Commenti

Per evitare di inserire inavvertitamente oggetti come System.Data.Common.CommandTrees e ObjectContext non sincronizzati con i relativi metadati, EntityConnection è necessario bloccare i metadati. Non sono consentite modifiche al stringa di connessione dopo il blocco dei metadati. Di seguito sono riportati due scenari in cui i metadati sono bloccati:

• L'istanza di viene costruita tramite il costruttore senza parametri o tramite il costruttore /> Open o GetMetadataWorkspace blocca i metadati.

• L'istanza EntityConnection viene costruita tramite il EntityConnection(MetadataWorkspace, DbConnection) costruttore , che accetta un MetadataWorkspace oggetto e .DbConnection In questo caso, i metadati vengono bloccati in fase di costruzione. Non sono mai consentite modifiche al stringa di connessione.

Quando vengono caricati i metadati, verifica EntityConnection che il modello concettuale, il modello di archiviazione e il file di mapping siano tutti presenti.

Per esempi di codice, vedere Uso di EntityClient.

Costruttori

Nome	Descrizione
EntityConnection()	Inizializza una nuova istanza della classe EntityConnection.
EntityConnection(MetadataWorkspace, DbConnection)	Inizializza una nuova istanza della classe EntityConnection con un MetadataWorkspace e un DbConnectionspecificati.
EntityConnection(String)	Inizializza una nuova istanza della classe EntityConnection, in base al stringa di connessione.

Proprietà

Nome	Descrizione
CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
ConnectionString	Ottiene o imposta l'EntityConnection stringa di connessione.
ConnectionTimeout	Ottiene il numero di secondi di attesa durante il tentativo di stabilire una connessione prima di terminare il tentativo e generare un errore.
Container	Ottiene l'oggetto IContainer contenente l'oggetto Component. (Ereditato da Component)
Database	Ottiene il nome del database corrente o il database che verrà utilizzato dopo l'apertura di una connessione.
DataSource	Ottiene il nome o l'indirizzo di rete dell'origine dati a cui connettersi.
DbProviderFactory	Ottiene l'oggetto per l'oggetto DbProviderFactoryDbConnection. (Ereditato da DbConnection)
DesignMode	Ottiene un valore che indica se è Component attualmente in modalità progettazione. (Ereditato da Component)
Events	Ottiene l'elenco dei gestori eventi associati a questo Componentoggetto . (Ereditato da Component)
ServerVersion	Ottiene una stringa contenente la versione dell'origine dati a cui è connesso il client.
Site	Ottiene o imposta il ISite del Component. (Ereditato da Component)
State	Ottiene la ConnectionState proprietà del provider sottostante se EntityConnection è aperto. In caso contrario, restituisce Closed.
StoreConnection	Fornisce l'accesso alla connessione all'origine dati sottostante utilizzata dall'oggetto EntityConnection .

Metodi

Nome	Descrizione
BeginDbTransaction(IsolationLevel)	Quando sottoposto a override in una classe derivata, avvia una transazione di database. (Ereditato da DbConnection)
BeginTransaction()	Avvia una transazione usando il provider sottostante.
BeginTransaction(IsolationLevel)	Avvia una transazione con il livello di isolamento specificato usando il provider sottostante.
ChangeDatabase(String)	Non supportato.
Close()	Chiude la connessione al database.
CreateCommand()	Crea una nuova istanza di un oggetto EntityCommand, con l'oggetto Connection impostato su .EntityConnection
CreateDbCommand()	Quando sottoposto a override in una classe derivata, crea e restituisce un DbCommand oggetto associato alla connessione corrente. (Ereditato da DbConnection)
CreateObjRef(Type)	Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto. (Ereditato da MarshalByRefObject)
EnlistTransaction(Transaction)	Inserisce l'oggetto EntityConnection nella transazione specificata.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
GetMetadataWorkspace()	Restituisce l'oggetto associato all'oggetto MetadataWorkspaceEntityConnection.
GetSchema()	Restituisce informazioni sullo schema per l'origine dati di questo DbConnectionoggetto . (Ereditato da DbConnection)
GetSchema(String, String[])	Restituisce informazioni sullo schema per l'origine dati di utilizzando DbConnection la stringa specificata per il nome dello schema e la matrice di stringhe specificata per i valori di restrizione. (Ereditato da DbConnection)
GetSchema(String)	Restituisce informazioni sullo schema per l'origine dati di utilizzando DbConnection la stringa specificata per il nome dello schema. (Ereditato da DbConnection)
GetService(Type)	Restituisce un oggetto che rappresenta un servizio fornito da Component o da Container. (Ereditato da Component)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Genera l'evento StateChange. (Ereditato da DbConnection)
Open()	Stabilisce una connessione all'origine dati chiamando il metodo del provider di Open dati sottostante.
OpenAsync()	Versione asincrona di , che apre una connessione di Open()database con le impostazioni specificate da ConnectionString. Questo metodo richiama il metodo OpenAsync(CancellationToken) virtuale con CancellationToken.None. (Ereditato da DbConnection)
OpenAsync(CancellationToken)	Si tratta della versione asincrona di Open(). I provider devono eseguire l'override con un'implementazione appropriata. Il token di annullamento può essere facoltativamente rispettato. L'implementazione predefinita richiama la chiamata sincrona Open() e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se è stato passato un oggetto cancellationToken già annullato. Le eccezioni generate da Open verranno comunicate tramite la proprietà Task Exception restituita. Non richiamare altri metodi e proprietà dell'oggetto DbConnection fino al completamento dell'attività restituita. (Ereditato da DbConnection)
ToString()	Restituisce un oggetto String contenente il nome dell'oggetto Component, se presente. Questo metodo non deve essere sottoposto a override. (Ereditato da Component)

Eventi

Nome	Descrizione
Disposed	Si verifica quando il componente viene eliminato da una chiamata al Dispose() metodo . (Ereditato da Component)
StateChange	Si verifica quando lo stato della connessione cambia. (Ereditato da DbConnection)

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IDbConnection.BeginTransaction()	Avvia una transazione di database. (Ereditato da DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Avvia una transazione di database con il livello di isolamento specificato. (Ereditato da DbConnection)
IDbConnection.CreateCommand()	Crea e restituisce un DbCommand oggetto associato alla connessione corrente. (Ereditato da DbConnection)

Vedi anche

• Provider EntityClient per Entity Framework
• Stringa di connessione