Classe EntityConnection (System.Data.EntityClient)

Cambia visualizzazione:
Classica
Lightweight
ScriptFree
Riferimento a .NET Framework
Classe EntityConnection
Il presente articolo è stato tradotto manualmente. Per visualizzare questa pagina e contemporaneamente visualizzarne il contenuto in lingua inglese, passare alla visualizzazione semplificata.

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

Gerarchia di ereditarietà
System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DbConnection
        System.Data.EntityClient.EntityConnection

Spazio dei nomi:  System.Data.EntityClient
Assembly:  System.Data.Entity (in System.Data.Entity.dll)
Sintassi
Visual Basic
Public NotInheritable Class EntityConnection _
	Inherits DbConnection
C#
public sealed class EntityConnection : DbConnection
Visual C++
public ref class EntityConnection sealed : public DbConnection
F#
[<Sealed>]
type EntityConnection =  
    class
        inherit DbConnection
    end

Il tipo EntityConnection espone i seguenti membri.

Costruttori
  Nome Descrizione
Metodo pubblico EntityConnection() Inizializza una nuova istanza della classe EntityConnection.
Metodo pubblico EntityConnection(String) Inizializza una nuova istanza della classe EntityConnection in base alla stringa di connessione.
Metodo pubblico EntityConnection(MetadataWorkspace, DbConnection) Inizializza una nuova istanza della classe EntityConnection con i MetadataWorkspace e DbConnection specificati.
In alto
Proprietà
  Nome Descrizione
Proprietà protetta. CanRaiseEvents Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
Proprietà pubblica ConnectionString Ottiene o imposta la stringa di connessione EntityConnection. (Esegue l'override di DbConnection.ConnectionString).
Proprietà pubblica ConnectionTimeout Ottiene il numero di secondi di attesa durante il tentativo di stabilire una connessione prima che il tentativo abbia fine e venga generato un errore. (Esegue l'override di DbConnection.ConnectionTimeout).
Proprietà pubblica Container Ottiene il IContainer che contiene il Component. (Ereditato da Component)
Proprietà pubblica Database Ottiene il nome del database corrente o del database che verrà utilizzato in seguito all'apertura di una connessione. (Esegue l'override di DbConnection.Database).
Proprietà pubblica DataSource Ottiene il nome o l'indirizzo di rete dell'origine dati a cui connettersi. (Esegue l'override di DbConnection.DataSource).
Proprietà protetta. DbProviderFactory Ottiene l'oggetto DbProviderFactory per questo oggetto DbConnection. (Ereditato da DbConnection)
Proprietà protetta. DesignMode Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component)
Proprietà protetta. Events Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component)
Proprietà pubblica ServerVersion Ottiene una stringa che contiene la versione dell'origine dati a cui è connesso il client. (Esegue l'override di DbConnection.ServerVersion).
Proprietà pubblica Site Ottiene o imposta il ISite del Component. (Ereditato da Component)
Proprietà pubblica State Ottiene la proprietà ConnectionState del provider sottostante se l'oggetto EntityConnection è aperto. In caso contrario, restituisce Closed. (Esegue l'override di DbConnection.State).
Proprietà pubblica StoreConnection Fornisce l'accesso alla connessione all'origine dati sottostante utilizzata dall'oggetto EntityConnection.
In alto
Metodi
  Nome Descrizione
Metodo protetto BeginDbTransaction Avvia una transazione di database. (Ereditato da DbConnection)
Metodo pubblico BeginTransaction() Inizia una transazione utilizzando il provider sottostante.
Metodo pubblico BeginTransaction(IsolationLevel) Inizia una transazione con il livello di isolamento specificato utilizzando il provider sottostante.
Metodo pubblico ChangeDatabase Non supportato. (Esegue l'override di DbConnection.ChangeDatabase(String)).
Metodo pubblico Close Chiude la connessione al database. (Esegue l'override di DbConnection.Close()).
Metodo pubblico CreateCommand Crea una nuova istanza di un oggetto EntityCommand, con Connection impostato su EntityConnection.
Metodo protetto CreateDbCommand Crea e restituisce un oggetto DbCommand associato alla connessione corrente. (Ereditato da DbConnection)
Metodo pubblico CreateObjRef 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)
Metodo pubblico Dispose() Libera tutte le risorse utilizzate da Component. (Ereditato da Component)
Metodo protetto Dispose(Boolean) Rilascia le risorse non gestite utilizzate dall'oggetto Component ed eventualmente rilascia le risorse gestite. (Ereditato da Component)
Metodo pubblico EnlistTransaction Inserisce EntityConnection nella transazione specificata. (Esegue l'override di DbConnection.EnlistTransaction(Transaction)).
Metodo pubblico Equals(Object) Determina se l'oggetto Object specificato è uguale all'oggetto Object corrente. (Ereditato da Object)
Metodo protetto Finalize Libera risorse non gestite ed esegue altre operazioni di pulitura prima che Component sia recuperato dalla procedura di Garbage Collection. (Ereditato da Component)
Metodo pubblico GetHashCode Funge da funzione hash per un determinato tipo. (Ereditato da Object)
Metodo pubblico GetLifetimeService Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
Metodo pubblico GetMetadataWorkspace Restituisce l'oggetto MetadataWorkspace associato a questa classe EntityConnection.
Metodo pubblico GetSchema() Restituisce informazioni sullo schema per l'origine dati di questo oggetto DbConnection. (Ereditato da DbConnection)
Metodo pubblico GetSchema(String) Restituisce le informazioni di schema per l'origine dati dell'oggetto DbConnection utilizzando la stringa specificata per il nome dello schema. (Ereditato da DbConnection)
Metodo pubblico 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)
Metodo protetto GetService Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component)
Metodo pubblico GetType Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblico InitializeLifetimeService Consente di ottenere un oggetto servizio di durata per il controllo dei criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
Metodo protetto MemberwiseClone() Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo protetto MemberwiseClone(Boolean) Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
Metodo protetto OnStateChange Genera l'evento StateChange. (Ereditato da DbConnection)
Metodo pubblico Open Stabilisce una connessione all'origine dati chiamando il metodo Open del provider di dati sottostante. (Esegue l'override di DbConnection.Open()).
Metodo pubblico ToString Restituisce un oggetto String contenente il nome dell'oggetto Component, se presente. Non è consigliabile eseguire l'override di questo metodo. (Ereditato da Component)
In alto
Eventi
  Nome Descrizione
Evento pubblico Disposed Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose. (Ereditato da Component)
Evento pubblico StateChange Viene generato quando lo stato dell'evento cambia. (Ereditato da DbConnection)
In alto
Implementazioni esplicite dell'interfaccia
  Nome Descrizione
Implementazione esplicita dell'interfaccia Metodo privato IDbConnection.BeginTransaction() Avvia una transazione di database. (Ereditato da DbConnection)
Implementazione esplicita dell'interfaccia Metodo privato IDbConnection.BeginTransaction(IsolationLevel) Avvia una transazione di database con il valore specificato di IsolationLevel. (Ereditato da DbConnection)
Implementazione esplicita dell'interfaccia Metodo privato IDbConnection.CreateCommand Crea e restituisce un oggetto DbCommand associato alla connessione corrente. (Ereditato da DbConnection)
In alto
Note

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 di EntityConnection viene costruita mediante il costruttore predefinito oppure tramite il costruttore EntityConnection(String) che accetta una stringa di connessione. In entrambi i casi, la stringa di connessione può essere modificata più volte prima dell'apertura della connessione. La chiamata a [M:System.Data.EntityClient.EntityConnection.Open()] o [M:System.Data.EntityClient.EntityConnection.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 gli esempi di codice, vedere Working with EntityClient.

Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5 SP1

.NET Framework Client Profile

Supportato in: 4
Piattaforme

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Codice thread safe
Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Vedere anche

Riferimenti

Spazio dei nomi System.Data.EntityClient

Altre risorse

EntityClient Provider for Entity Framework
Working with EntityClient
Connection String