EntityConnection Classe

Riferimento

Definizione

Spazio dei nomi:: System.Data.EntityClient

Assembly:: System.Data.Entity.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Contiene un riferimento a un modello concettuale e a una connessione all'origine dati. La 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 che oggetti quali System.Data.Common.CommandTrees e ObjectContext risultino inavvertitamente non sincronizzati con i relativi metadati, è necessario che l'oggetto EntityConnection blocchi i propri metadati. Dopo il blocco dei metadati, non è consentito apportare alcuna modifica alla stringa di connessione. Nei due scenari seguenti viene illustrato il blocco dei metadati:

L'istanza EntityConnection viene costruita tramite il costruttore senza parametri o tramite il EntityConnection(String) costruttore, che accetta un stringa di connessione. In entrambi i casi, la stringa di connessione può essere modificata più volte prima dell'apertura della connessione. La chiamata a Open o GetMetadataWorkspace determina il blocco dei metadati.
L'istanza di EntityConnection viene costruita mediante il costruttore EntityConnection(MetadataWorkspace, DbConnection) che accetta un oggetto MetadataWorkspace e un oggetto DbConnection. In questo caso, i metadati vengono bloccati in fase di costruzione. Non è mai consentito apportare modifiche alla stringa di connessione.

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

Per esempi di codice, vedere Uso di EntityClient.

Costruttori

EntityConnection()	Inizializza una nuova istanza della classe EntityConnection.
EntityConnection(MetadataWorkspace, DbConnection)	Inizializza una nuova istanza della classe EntityConnection con gli oggetti MetadataWorkspace e DbConnection specificati.
EntityConnection(String)	Inizializza una nuova istanza della classe EntityConnection in base alla stringa di connessione.

Proprietà

CanCreateBatch	Ottiene un valore che indica se questa istanza di DbConnection supporta la classe DbBatch. (Ereditato da DbConnection)
CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
ConnectionString	Ottiene o imposta la stringa di connessione EntityConnection.
ConnectionTimeout	Ottiene il numero di secondi di attesa durante il tentativo di stabilire una connessione prima che il tentativo termini e venga generato un errore.
Container	Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
Database	Ottiene il nome del database corrente o del database che verrà utilizzato in seguito all'apertura di una connessione.
DataSource	Ottiene il nome o l'indirizzo di rete dell'origine dati a cui connettersi.
DbProviderFactory	Ottiene l'oggetto DbProviderFactory per l'oggetto DbConnection. (Ereditato da DbConnection)
DesignMode	Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component)
Events	Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component)
ServerVersion	Ottiene una stringa che contiene la versione dell'origine dati a cui è connesso il client.
Site	Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component)
State	Ottiene la proprietà ConnectionState 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

BeginDbTransaction(IsolationLevel)	In caso di override in una classe derivata, avvia una transazione di database. (Ereditato da DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Avvia una transazione di database in modo asincrono. (Ereditato da DbConnection)
BeginTransaction()	Inizia una transazione utilizzando il provider sottostante.
BeginTransaction(IsolationLevel)	Avvia una transazione con il livello di isolamento specificato usando il provider sottostante.
BeginTransactionAsync(CancellationToken)	Avvia una transazione di database in modo asincrono. (Ereditato da DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Avvia una transazione di database in modo asincrono. (Ereditato da DbConnection)
ChangeDatabase(String)	Non supportato.
ChangeDatabaseAsync(String, CancellationToken)	Cambia il database corrente in modo asincrono per una connessione aperta. (Ereditato da DbConnection)
Close()	Chiude la connessione al database.
CloseAsync()	Chiude la connessione al database in modo asincrono. (Ereditato da DbConnection)
CreateBatch()	Restituisce una nuova istanza della classe del provider che implementa la classe DbBatch. (Ereditato da DbConnection)
CreateCommand()	Crea una nuova istanza di un oggetto EntityCommand, con Connection impostato su EntityConnection.
CreateDbBatch()	Quando sottoposto a override in una classe derivata, restituisce una nuova istanza della classe del provider che implementa la DbBatch classe . (Ereditato da DbConnection)
CreateDbCommand()	In caso di override in una classe derivata, crea e restituisce un oggetto DbCommand associato alla connessione corrente. (Ereditato da DbConnection)
CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite. (Ereditato da DbConnection)
Dispose(Boolean)	Rilascia le risorse non gestite usate da DbConnection e, facoltativamente, le risorse gestite. (Ereditato da DbConnection)
DisposeAsync()	Elimina in modo asincrono l'oggetto connessione. (Ereditato da DbConnection)
EnlistTransaction(Transaction)	Inserisce 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()	Obsoleti. Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetMetadataWorkspace()	Restituisce l'oggetto MetadataWorkspace associato a EntityConnection.
GetSchema()	Restituisce informazioni sullo schema per l'origine dati di questo oggetto DbConnection. (Ereditato da DbConnection)
GetSchema(String)	Restituisce le informazioni di schema per l'origine dati dell'oggetto DbConnection usando la stringa specificata per il nome dello schema. (Ereditato da DbConnection)
GetSchema(String, String[])	Restituisce le informazioni di schema per l'origine dati dell'oggetto DbConnection utilizzando la stringa specificata per il nome dello schema e la matrice di stringhe specificata per i valori di restrizione. (Ereditato da DbConnection)
GetSchemaAsync(CancellationToken)	Si tratta di una versione asincrona di GetSchema(). I provider devono eseguire l'override con un'implementazione appropriata. `cancellationToken` può facoltativamente essere rispettato. L'implementazione predefinita richiama la chiamata sincrona GetSchema() e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se viene passato un `cancellationToken` già annullato. Le eccezioni generate da GetSchema() verranno passate mediante la proprietà Task Exception restituita. (Ereditato da DbConnection)
GetSchemaAsync(String, CancellationToken)	Si tratta della versione asincrona di GetSchema(String). I provider devono eseguire l'override con un'implementazione appropriata. `cancellationToken` può facoltativamente essere rispettato. L'implementazione predefinita richiama la chiamata sincrona GetSchema(String) e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se viene passato un `cancellationToken` già annullato. Le eccezioni generate da GetSchema(String) verranno passate mediante la proprietà Task Exception restituita. (Ereditato da DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Si tratta della versione asincrona di GetSchema(String, String[]). I provider devono eseguire l'override con un'implementazione appropriata. `cancellationToken` può facoltativamente essere rispettato. L'implementazione predefinita richiama la chiamata sincrona GetSchema(String, String[]) e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se viene passato un `cancellationToken` già annullato. Le eccezioni generate da GetSchema(String, String[]) verranno passate mediante la proprietà Task Exception restituita. (Ereditato da DbConnection)
GetService(Type)	Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Genera l'evento StateChange. (Ereditato da DbConnection)
Open()	Stabilisce una connessione all'origine dati chiamando il metodo `Open` del provider di dati sottostante.
OpenAsync()	Versione asincrona di Open(), che apre una connessione di database con le impostazioni specificate da ConnectionString. Questo metodo richiama il metodo virtuale OpenAsync(CancellationToken) 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ò facoltativamente essere rispettato. L'implementazione predefinita richiama la chiamata sincrona Open() e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se viene passato un cancellationToken già annullato. Le eccezioni generate da Open verranno passate mediante la proprietà Task Exception restituita. Non richiamare altri metodi e proprietà dell'oggetto `DbConnection` finché l'attività restituita non viene completata. (Ereditato da DbConnection)
ToString()	Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component. Questo metodo non deve essere sottoposto a override. (Ereditato da Component)

Eventi

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

Implementazioni dell'interfaccia esplicita

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

Si applica a