Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe OleDbConnection

 

Data di pubblicazione: novembre 2016

Rappresenta una connessione aperta a un'origine dati.

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

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DbConnection
        System.Data.OleDb.OleDbConnection

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

NomeDescrizione
System_CAPS_pubmethodOleDbConnection()

Inizializza una nuova istanza della classe OleDbConnection.

System_CAPS_pubmethodOleDbConnection(String)

Inizializza una nuova istanza di OleDbConnection classe con la stringa di connessione specificata.

NomeDescrizione
System_CAPS_pubpropertyConnectionString

Ottiene o imposta la stringa usata per aprire un database.(Esegue l'override di DbConnection.ConnectionString.)

System_CAPS_pubpropertyConnectionTimeout

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

System_CAPS_pubpropertyContainer

Ottiene il IContainer che contiene il Component.(Ereditato da Component.)

System_CAPS_pubpropertyDatabase

Ottiene il nome del database corrente o del database da usare dopo l'apertura della connessione.(Esegue l'override di DbConnection.Database.)

System_CAPS_pubpropertyDataSource

Ottiene il nome del server o il nome del file dell'origine dati.(Esegue l'override di DbConnection.DataSource.)

System_CAPS_pubpropertyProvider

Ottiene il nome del provider OLE DB specificato nel "Provider =" clausola della stringa di connessione.

System_CAPS_pubpropertyServerVersion

Ottiene una stringa che contiene la versione del server a cui è connesso il client.(Esegue l'override di DbConnection.ServerVersion.)

System_CAPS_pubpropertySite

Ottiene o imposta il ISite di Component.(Ereditato da Component.)

System_CAPS_pubpropertyState

Ottiene lo stato corrente della connessione.(Esegue l'override di DbConnection.State.)

NomeDescrizione
System_CAPS_pubmethodBeginTransaction()

Avvia una transazione di database con l'oggetto IsolationLevel valore.

System_CAPS_pubmethodBeginTransaction(IsolationLevel)

Inizia una transazione di database con il livello di isolamento specificato.

System_CAPS_pubmethodChangeDatabase(String)

Modifica il database corrente per un oggetto OleDbConnection aperto.(Esegue l'override di DbConnection.ChangeDatabase(String).)

System_CAPS_pubmethodClose()

Chiude la connessione all'origine dati.(Esegue l'override di DbConnection.Close().)

System_CAPS_pubmethodCreateCommand()

Crea e restituisce un OleDbCommand oggetto associato di OleDbConnection.

System_CAPS_pubmethodCreateObjRef(Type)

Crea un oggetto che contiene le informazioni necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto.(Ereditato da MarshalByRefObject.)

System_CAPS_pubmethodDispose()

Rilascia tutte le risorse usate da Component.(Ereditato da Component.)

System_CAPS_pubmethodEnlistDistributedTransaction(ITransaction)

Permette l'integrazione nella transazione specificata come transazione distribuita.

System_CAPS_pubmethodEnlistTransaction(Transaction)

Permette l'integrazione nella transazione specificata come transazione distribuita.(Esegue l'override di DbConnection.EnlistTransaction(Transaction).)

System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object.)

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetLifetimeService()

Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza.(Ereditato da MarshalByRefObject.)

System_CAPS_pubmethodGetOleDbSchemaTable(Guid, Object[])

Restituisce informazioni sullo schema da un'origine dati, come indicato da un GUID e dopo aver applicato le restrizioni specificate.

System_CAPS_pubmethodGetSchema()

Restituisce informazioni sullo schema per l'origine dati dell'oggetto OleDbConnection.(Esegue l'override di DbConnection.GetSchema().)

System_CAPS_pubmethodGetSchema(String)

Restituisce le informazioni di schema per l'origine dati dell'oggetto OleDbConnection usando la stringa specificata per il nome dello schema.(Esegue l'override di DbConnection.GetSchema(String).)

System_CAPS_pubmethodGetSchema(String, String[])

Restituisce informazioni sullo schema per l'origine dati dell'oggetto OleDbConnection utilizzando la stringa specificata per il nome dello schema e la matrice di stringa specificata per i valori di restrizione.(Esegue l'override di DbConnection.GetSchema(String, String[]).)

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_pubmethodInitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.(Ereditato da MarshalByRefObject.)

System_CAPS_pubmethodOpen()

Apre una connessione al database con le impostazioni di proprietà specificate dal ConnectionString.(Esegue l'override di DbConnection.Open().)

System_CAPS_pubmethodOpenAsync()

Una versione asincrona del Open, che apre una connessione al database con le impostazioni specificate per il ConnectionString. Questo metodo richiama il metodo virtuale OpenAsync con CancellationToken.None.(Ereditato da DbConnection.)

System_CAPS_pubmethodOpenAsync(CancellationToken)

Questa è la versione asincrona di Open. I provider devono eseguire l'override con un'implementazione appropriata. Facoltativamente è possibile rispettare il token di annullamento.

L'implementazione predefinita richiama sincroni Open chiamare e restituisce un'attività completata. L'implementazione predefinita restituisce un'attività annullata se passato un oggetto cancellationToken già annullata. Le eccezioni generate da Open verranno comunicate tramite la proprietà dell'attività eccezione restituita.

Non richiamare altri metodi e le proprietà di DbConnection dell'oggetto fino al completamento dell'attività restituita.(Ereditato da DbConnection.)

System_CAPS_pubmethodSystem_CAPS_staticReleaseObjectPool()

Indica che il OleDbConnection pool di oggetti può essere rilasciato quando viene rilasciata l'ultima connessione sottostante.

System_CAPS_pubmethodResetState()

Gli aggiornamenti di State proprietà del OleDbConnection oggetto.

System_CAPS_pubmethodToString()

Restituisce un String contenente il nome del Component, se presente. Questo metodo non deve essere sottoposto a override.(Ereditato da Component.)

NomeDescrizione
System_CAPS_pubeventDisposed

Si verifica quando il componente viene eliminato da una chiamata al Dispose metodo.(Ereditato da Component.)

System_CAPS_pubeventInfoMessage

Si verifica quando il provider invia un messaggio di avviso o un messaggio informativo.

System_CAPS_pubeventStateChange

Si verifica quando lo stato dell'evento cambia.(Ereditato da DbConnection.)

NomeDescrizione
System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbConnection.BeginTransaction()

Avvia una transazione di database.(Ereditato da DbConnection.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbConnection.BeginTransaction(IsolationLevel)

Avvia una transazione di database con il valore specificato di IsolationLevel.(Ereditato da DbConnection.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDbConnection.CreateCommand()

Crea e restituisce un oggetto DbCommand associato alla connessione corrente.(Ereditato da DbConnection.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICloneable.Clone()

Per una descrizione di questo membro, vedere ICloneable.Clone.

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

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

È possibile aprire più di un oggetto DataReader su un singolo OleDbConnection. Se in un'unica connessione del provider OLE DB in uso non supporta più di un oggetto DataReader, il provider apre in modo implicito una connessione aggiuntiva per ognuna.

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

System_CAPS_noteNota

Per distribuire applicazioni a prestazioni elevate, è necessario utilizzare il pool di connessioni. Quando si utilizza il Provider di dati .NET Framework per OLE DB, non è necessario abilitare il pool di connessioni poiché il provider gestito automaticamente. Per ulteriori informazioni sull'utilizzo di connessione del pool con il Provider di dati .NET Framework per OLE DB, vedere Pool di connessioni OLEDB, ODBC e Oracle.

Se un errore irreversibile OleDbException (ad esempio, SQL Server livello di gravità pari a 20 o supera) viene generato dal metodo che esegue un OleDbCommand, OleDbConnection potrebbe essere chiusa. L'utente può tuttavia riaprire la connessione e continuare.

Un'applicazione che crea un'istanza di OleDbConnection oggetto può richiedere tutti i chiamanti diretti e indiretti dispongano di autorizzazioni sufficienti per il codice, l'impostazione di richieste di sicurezza dichiarativo o imperativo. OleDbConnection effettua richieste di sicurezza utilizzando il OleDbPermission oggetto. Gli utenti possono verificare che il codice disponga di autorizzazioni sufficienti mediante il OleDbPermissionAttribute oggetto. Gli utenti e amministratori possono inoltre utilizzare il Caspol.exe (Code Access Security Policy Tool) per modificare i criteri di sicurezza a livello aziendale, utente e computer di. Per altre informazioni, vedere Sicurezza dall'accesso di codice e ADO.NET.

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

System_CAPS_noteNota

Il OleDbConnection oggetto non supporta l'impostazione o recupero di proprietà dinamiche specifiche di un provider OLE DB. Sono supportate esclusivamente le proprietà che possono essere passate nella stringa di connessione per il provider OLE DB.

Nell'esempio seguente viene creato un OleDbCommand e OleDbConnection. Il OleDbConnection viene aperto e impostato come il Connection per il OleDbCommand. Nell'esempio viene quindi chiamato ExecuteNonQuery e chiude la connessione. A tale scopo, 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
Disponibile da 1.1

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: