EntityConnection Costruttori

Definizione

Spazio dei nomi:

System.Data.EntityClient

Assembly:

System.Data.Entity.dll

Inizializza una nuova istanza della classe EntityConnection.

Overload

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

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 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 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.

EntityConnection()

Inizializza una nuova istanza della classe EntityConnection.

public:
 EntityConnection();

public EntityConnection ();

Public Sub New ()

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 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 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.

EntityConnection(String)

Inizializza una nuova istanza della classe EntityConnection in base alla stringa di connessione.

public:
 EntityConnection(System::String ^ connectionString);

public EntityConnection (string connectionString);

new System.Data.EntityClient.EntityConnection : string -> System.Data.EntityClient.EntityConnection

Public Sub New (connectionString As String)

Parametri

connectionString

String

Stringa di connessione specifica del provider.

Eccezioni

ArgumentException

È stata specificata una parola chiave per la stringa di connessione non valida oppure non è stata specificata una parola chiave per la stringa di connessione obbligatoria.

Commenti

Gli strumenti Entity Data Model generano una stringa di connessione denominata archiviata nel file di configurazione dell'applicazione. Questa stringa di connessione denominata può essere fornita al posto del parametro quando si crea un'istanza connectionString della EntityConnection classe.

Per evitare che gli oggetti 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 questo 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 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.

EntityConnection(MetadataWorkspace, DbConnection)

Inizializza una nuova istanza della classe EntityConnection con gli oggetti MetadataWorkspace e DbConnection specificati.

public:
 EntityConnection(System::Data::Metadata::Edm::MetadataWorkspace ^ workspace, System::Data::Common::DbConnection ^ connection);

public EntityConnection (System.Data.Metadata.Edm.MetadataWorkspace workspace, System.Data.Common.DbConnection connection);

new System.Data.EntityClient.EntityConnection : System.Data.Metadata.Edm.MetadataWorkspace * System.Data.Common.DbConnection -> System.Data.EntityClient.EntityConnection

Public Sub New (workspace As MetadataWorkspace, connection As DbConnection)

Parametri

workspace

MetadataWorkspace

Oggetto MetadataWorkspace da associare all'oggetto EntityConnection.

connection

DbConnection

Connessione all'origine dati sottostante per l'oggetto EntityConnection.

Eccezioni

ArgumentNullException

Il parametro workspace o il parametro connection è null.

ArgumentException

Nell'area di lavoro manca il modello concettuale.

-oppure-

Nell'area di lavoro manca il file di mapping.

-oppure-

Nell'area di lavoro manca il modello di archiviazione.

-oppure-

L'oggetto connection non è in uno stato chiuso.

ProviderIncompatibleException

Il parametro connection non proviene da un provider compatibile con ADO.NET Entity Framework.

Commenti

Questo costruttore consente di creare un oggetto EntityConnection da metadati non inclusi in un file su un disco o in una risorsa incorporata in un assembly.

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 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 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.