Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Classe OleDbConnection

Rappresenta una connessione aperta a un'origine dati.

Spazio dei nomi:  System.Data.OleDb
Assembly:  System.Data (in System.Data.dll)

public sealed class OleDbConnection : DbConnection, 
	ICloneable, IDbConnection, IDisposable

Il tipo OleDbConnection espone i seguenti membri.

  NomeDescrizione
Metodo pubblicoOleDbConnection()Inizializza una nuova istanza della classe OleDbConnection.
Metodo pubblicoOleDbConnection(String)Inizializza una nuova istanza della classe OleDbConnection con la stringa di connessione specificata.
In alto

  NomeDescrizione
Proprietà pubblicaConnectionStringOttiene o imposta la stringa utilizzata per aprire un database. (Esegue l'override di DbConnection.ConnectionString).
Proprietà pubblicaConnectionTimeoutOttiene il tempo di attesa relativo al tentativo di stabilire una connessione prima di terminare il tentativo e generare un errore. (Esegue l'override di DbConnection.ConnectionTimeout).
Proprietà pubblicaContainerOttiene il IContainer che contiene il Component. (Ereditato da Component)
Proprietà pubblicaDatabaseOttiene il nome del database corrente o del database da utilizzare una volta aperta la connessione. (Esegue l'override di DbConnection.Database).
Proprietà pubblicaDataSourceOttiene il nome server o il nome file dell'origine dati. (Esegue l'override di DbConnection.DataSource).
Proprietà pubblicaProviderOttiene il nome del provider OLE DB specificato nella clausola "Provider= " della stringa di connessione.
Proprietà pubblicaServerVersionOttiene una stringa che contiene la versione del server a cui è connesso il client. (Esegue l'override di DbConnection.ServerVersion).
Proprietà pubblicaSiteOttiene o imposta il ISite del Component. (Ereditato da Component)
Proprietà pubblicaStateOttiene lo stato corrente della connessione. (Esegue l'override di DbConnection.State).
In alto

  NomeDescrizione
Metodo pubblicoBeginTransaction()Avvia una transazione di database con il valore IsolationLevel corrente.
Metodo pubblicoBeginTransaction(IsolationLevel)Inizia una transazione di database con il livello di isolamento specificato.
Metodo pubblicoChangeDatabaseModifica il database corrente per un oggetto OleDbConnection aperto. (Esegue l'override di DbConnection.ChangeDatabase(String)).
Metodo pubblicoCloseChiude la connessione all'origine dati. (Esegue l'override di DbConnection.Close()).
Metodo pubblicoCreateCommandCrea e restituisce un oggetto OleDbCommand associato alla classe OleDbConnection.
Metodo pubblicoCreateObjRefConsente 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 pubblicoDispose()Rilascia tutte le risorse utilizzate dall'oggetto Component. (Ereditato da Component)
Metodo pubblicoEnlistDistributedTransactionConsente l'inserimento nella transazione specificata come transazione distribuita.
Metodo pubblicoEnlistTransactionConsente l'inserimento nella transazione specificata come transazione distribuita. (Esegue l'override di DbConnection.EnlistTransaction(Transaction)).
Metodo pubblicoEquals(Object) Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Metodo pubblicoGetHashCode Funge da funzione hash per un particolare tipo. (Ereditato da Object)
Metodo pubblicoGetLifetimeServiceConsente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
Metodo pubblicoGetOleDbSchemaTableRestituisce informazioni di schema da un'origine dati come indicato da un GUID e dopo l'applicazione delle restrizioni specificate.
Metodo pubblicoGetSchema()Restituisce le informazioni di schema per l'origine dati dell'oggetto OleDbConnection. (Esegue l'override di DbConnection.GetSchema()).
Metodo pubblicoGetSchema(String)Restituisce le informazioni di schema per l'origine dati dell'oggetto OleDbConnection utilizzando la stringa specificata per il nome dello schema. (Esegue l'override di DbConnection.GetSchema(String)).
Metodo pubblicoGetSchema(String, String[])Restituisce le informazioni di schema per l'origine dati dell'oggetto OleDbConnection utilizzando la stringa specificata per il nome dello schema e la matrice di stringhe specificata per i valori di restrizione. (Esegue l'override di DbConnection.GetSchema(String, String[])).
Metodo pubblicoGetType Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblicoInitializeLifetimeServiceConsente di ottenere un oggetto servizio di durata per il controllo dei criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
Metodo pubblicoOpenApre una connessione a un database con le impostazioni delle proprietà specificate dalla proprietà ConnectionString. (Esegue l'override di DbConnection.Open()).
Metodo pubblicoOpenAsync()Versione asincrona di Open, che apre una connessione di database con le impostazioni specificate da ConnectionString. Questo metodo richiama il metodo virtuale OpenAsync con CancellationToken.None. (Ereditato da DbConnection)
Metodo pubblicoOpenAsync(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)
Metodo pubblicoMembro staticoReleaseObjectPoolIndica che il pool di oggetti OleDbConnection può essere rilasciato quando viene rilasciata l'ultima connessione sottostante.
Metodo pubblicoResetStateAggiorna la proprietà State dell'oggetto OleDbConnection.
Metodo pubblicoToStringRestituisce un oggetto String contenente il nome dell'oggetto Component, se presente. Non è consigliabile eseguire l'override di questo metodo. (Ereditato da Component)
In alto

  NomeDescrizione
Evento pubblicoDisposedSi verifica quando il componente viene eliminato da una chiamata al metodo Dispose. (Ereditato da Component)
Evento pubblicoInfoMessageViene generato quando il provider invia un avviso o un messaggio informativo.
Evento pubblicoStateChangeViene generato quando lo stato dell'evento cambia. (Ereditato da DbConnection)
In alto

  NomeDescrizione
Implementazione esplicita dell'interfacciaMetodo privatoICloneable.ClonePer una descrizione di questo membro, vedere ICloneable.Clone.
Implementazione esplicita dell'interfacciaMetodo privatoIDbConnection.BeginTransaction()Avvia una transazione di database. (Ereditato da DbConnection)
Implementazione esplicita dell'interfacciaMetodo privatoIDbConnection.BeginTransaction(IsolationLevel)Avvia una transazione di database con il valore specificato di IsolationLevel. (Ereditato da DbConnection)
Implementazione esplicita dell'interfacciaMetodo privatoIDbConnection.CreateCommandCrea e restituisce un oggetto DbCommand associato alla connessione corrente. (Ereditato da DbConnection)
In alto

Un oggetto OleDbConnection rappresenta una connessione univoca a un'origine dati. Nel caso di un sistema di database client/server, è equivalente a una connessione di rete al server. A seconda delle funzionalità supportate dal provider OLE DB nativo, è possibile che alcuni metodi o proprietà di un oggetto OleDbConnection non siano disponibili.

Quando si crea un'istanza della classe OleDbConnection tutte le proprietà vengono impostate sui valori iniziali. Per un elenco di questi valori, vedere il costruttore del metodo OleDbConnection.

È possibile aprire più di un oggetto DataReader su un'unica classe OleDbConnection. Se il provider OLE DB utilizzato non supporta più di un oggetto DataReader su un'unica connessione, aprirà in modo implicito una connessione aggiuntiva per ciascun oggetto.

Se la classe OleDbConnection esula dall'ambito preposto, non viene chiusa. Pertanto, è necessario chiudere in modo esplicito la connessione, chiamando il metodo Close o Dispose oppure utilizzando l'oggetto OleDbConnection all'interno di un'istruzione Using.

NotaNota

Per distribuire applicazioni dalle prestazioni elevate, è necessario utilizzare un pool di connessioni. Quando si utilizza il provider di dati .NET Framework di OLE DB, non è necessario attivare il pool di connessioni poiché questa operazione è gestita automaticamente dal provider. Per ulteriori informazioni sull'utilizzo del pool di connessioni con il provider di dati .NET Framework di OLE DB, vedere Pool di connessioni OLEDB, ODBC e Oracle.

Se viene generato un errore irreversibile OleDbException, ad esempio un livello di gravità SQL Server 20 o superiore, dal metodo che esegue un oggetto OleDbCommand, l'oggetto OleDbConnection verrà chiuso. L'utente può tuttavia riaprire la connessione e continuare.

È possibile che un'applicazione con cui si crea un'istanza dell'oggetto OleDbConnection richieda che tutti i chiamanti diretti o indiretti dispongano di autorizzazioni sufficienti per il codice, con l'impostazione di richieste di sicurezza dichiarative o imperative. OleDbConnection consente la creazione di richieste di sicurezza mediante l'oggetto OleDbPermission. Gli utenti possono verificare che il proprio codice disponga delle autorizzazioni sufficienti mediante l'oggetto OleDbPermissionAttribute. Gli utenti e gli amministratori possono inoltre utilizzare Caspol.exe (strumento per i criteri di sicurezza dall'accesso di codice) per modificare il criterio di sicurezza a livello aziendale, di utente e di computer. Per ulteriori informazioni, vedere Sicurezza dall'accesso di codice e ADO.NET.

Per ulteriori informazioni sulla gestione di messaggi di avviso e informativi dal server di dati, vedere Eventi di connessione.

NotaNota

L'oggetto OleDbConnection non supporta l'impostazione o il recupero di proprietà dinamiche specifiche di un provider OLE DB. Sono supportate esclusivamente le proprietà che è possibile passare nella stringa di connessione per il provider OLE DB.

Nell'esempio riportato di seguito viene creato un oggetto OleDbCommand e un oggetto OleDbConnection. L'oggetto OleDbConnection viene aperto e impostato come la proprietà Connection per l'oggetto OleDbCommand. Nell'esempio viene quindi chiamato ExecuteNonQuery e la connessione viene chiusa. A tal fine, al metodo ExecuteNonQuery viene passata una stringa di connessione e una stringa di query che rappresenta un'istruzione SQL INSERT.


public void InsertRow(string connectionString, string insertSQL)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        // The insertSQL string contains a SQL statement that
        // inserts a new row in the source table.
        OleDbCommand command = new OleDbCommand(insertSQL);

        // Set the Connection to the new OleDbConnection.
        command.Connection = connection;

        // Open the connection and execute the insert command.
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
}


.NET Framework

Supportato in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Aggiunte alla community

AGGIUNGI
Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2014 Microsoft