OracleConnection Classe

Definizione

Spazio dei nomi:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Attenzione

OracleConnection has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

Rappresenta una connessione aperta a un database. La classe non può essere ereditata.

public ref class OracleConnection sealed : System::Data::Common::DbConnection, ICloneable

[System.Obsolete("OracleConnection has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleConnection : System.Data.Common.DbConnection, ICloneable

[<System.Obsolete("OracleConnection has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleConnection = class
    inherit DbConnection
    interface ICloneable

Public NotInheritable Class OracleConnection
Inherits DbConnection
Implements ICloneable

Ereditarietà

Object

MarshalByRefObject

Component

DbConnection

OracleConnection

Attributi

ObsoleteAttribute

Implementazioni

ICloneable

Esempio

Nell'esempio seguente viene creato un OracleCommand oggetto e un OracleConnectionoggetto . L'oggetto OracleConnectionOracleCommand.Connection viene aperto e impostato come proprietà. Nell'esempio viene quindi chiamato ExecuteNonQuerye viene chiusa la connessione. A tale scopo, viene passata una stringa di connessione e una stringa di query che rappresenta un'istruzione ExecuteNonQuery SQL INSERT.

public void InsertRow(string connectionString)
{
    string queryString =
        "INSERT INTO Dept (DeptNo, Dname, Loc) values (50, 'TECHNOLOGY', 'DENVER')";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(queryString);
        command.Connection = connection;
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}

Public Sub InsertRow(ByVal connectionString As String)
    Dim queryString As String = _
      "INSERT INTO Dept (DeptNo, Dname, Loc) values (50, 'TECHNOLOGY', 'DENVER')"

    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(queryString)
        command.Connection = connection
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
    End Using
End Sub

Commenti

Questo tipo è deprecato e verrà rimosso in una versione futura di .NET Framework. Per altre informazioni, vedere Oracle e ADO.NET.

Un OracleConnection oggetto rappresenta una connessione univoca a un database Oracle. Nel caso di un sistema di database client/server, equivale a una connessione di rete al server.

Un'applicazione che crea un'istanza dell'oggetto OracleConnection può impostare richieste di sicurezza dichiarative o imperative che richiedono a tutti i chiamanti diretti e indiretti di disporre di autorizzazioni adeguate per il codice. OracleConnection crea richieste di sicurezza usando l'oggetto OraclePermission . Gli utenti possono verificare che il codice disponga di autorizzazioni adeguate usando l'oggetto OraclePermissionAttribute . Gli utenti e gli amministratori possono anche usare lo strumento criteri di sicurezza di accesso al codice (Caspol.exe) per modificare i criteri di sicurezza nel computer, nell'utente e nei livelli aziendali. Per altre informazioni, vedere Sicurezza.

Nota

A differenza dell'oggetto Connection negli altri provider di dati di .NET Framework (SQL Server, OLE DB e ODBC), OracleConnection non supporta una ConnectionTimeout proprietà. L'impostazione di un timeout di connessione come proprietà o nella stringa di connessione non ha alcun effetto e il valore restituito è sempre zero. OracleConnection non supporta anche una proprietà o un DatabaseChangeDatabase metodo.

Se l'oggetto esce dall'ambito OracleConnection , rimane aperto. Pertanto, è consigliabile chiudere OracleConnection sempre gli oggetti chiamando Close o Dispose oppure usando l'oggetto all'interno di un'istruzione OracleConnectionUsing . In caso contrario, la Garbage Collection potrebbe non liberarli immediatamente. Tali ritardi possono causare errori se il numero massimo di connessioni viene raggiunto mentre un numero di connessioni è in attesa di essere eliminato dal Garbage Collector. Al contrario, chiudere le connessioni chiamando Close usa risorse native in modo più efficiente, migliorando la scalabilità e migliorando le prestazioni complessive dell'applicazione. Per assicurarsi che le connessioni siano sempre chiuse, aprire la connessione all'interno di un Using blocco.

Nota

Per distribuire applicazioni ad alte prestazioni, spesso è necessario usare il pool di connessioni. Tuttavia, quando si usa il provider di dati .NET Framework per Oracle, non è necessario abilitare il pool di connessioni perché il provider gestisce automaticamente questa operazione.

Costruttori

OracleConnection()	Obsoleti. Inizializza una nuova istanza dell'oggetto OracleConnection.
OracleConnection(String)	Obsoleti. Inizializza una nuova istanza della classe OracleConnection con la stringa di connessione specificata.

Proprietà

CanCreateBatch	Obsoleti. Ottiene un valore che indica se questa istanza di DbConnection supporta la classe DbBatch. (Ereditato da DbConnection)
CanRaiseEvents	Obsoleti. Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
ConnectionString	Obsoleti. Ottiene o imposta la stringa utilizzata per aprire un database Oracle.
ConnectionTimeout	Obsoleti. Ottiene il tempo di attesa per stabilire una connessione, prima di terminare il tentativo e generare un errore.
Container	Obsoleti. Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
Database	Obsoleti. Ottiene il nome del database corrente o del database da usare dopo l'apertura della connessione.
DataSource	Obsoleti. Ottiene il nome del server Oracle a cui effettuare la connessione.
DbProviderFactory	Obsoleti. Ottiene l'oggetto DbProviderFactory per l'oggetto DbConnection. (Ereditato da DbConnection)
DesignMode	Obsoleti. Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component)
Events	Obsoleti. Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component)
ServerVersion	Obsoleti. Ottiene una stringa che contiene la versione del server a cui è connesso il client.
Site	Obsoleti. Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component)
State	Obsoleti. Ottiene lo stato corrente della connessione.

Metodi

BeginDbTransaction(IsolationLevel)	Obsoleti. In caso di override in una classe derivata, avvia una transazione di database. (Ereditato da DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Obsoleti. Avvia una transazione di database in modo asincrono. (Ereditato da DbConnection)
BeginTransaction()	Obsoleti. Avvia una transazione nel database.
BeginTransaction(IsolationLevel)	Obsoleti. Avvia una transazione nel database con il valore di IsolationLevel specificato.
BeginTransactionAsync(CancellationToken)	Obsoleti. Avvia una transazione di database in modo asincrono. (Ereditato da DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Obsoleti. Avvia una transazione di database in modo asincrono. (Ereditato da DbConnection)
ChangeDatabase(String)	Obsoleti. Modifica il database corrente per un oggetto OracleConnection aperto.
ChangeDatabaseAsync(String, CancellationToken)	Obsoleti. Cambia il database corrente in modo asincrono per una connessione aperta. (Ereditato da DbConnection)
ClearAllPools()	Obsoleti. Svuota il pool di connessioni.
ClearPool(OracleConnection)	Obsoleti. Svuota il pool di connessioni associato alla connessione specificata.
Close()	Obsoleti. Chiude la connessione al database.
CloseAsync()	Obsoleti. Chiude la connessione al database in modo asincrono. (Ereditato da DbConnection)
CreateBatch()	Obsoleti. Restituisce una nuova istanza della classe del provider che implementa la classe DbBatch. (Ereditato da DbConnection)
CreateCommand()	Obsoleti. Crea e restituisce un oggetto OracleCommand associato alla classe OracleConnection.
CreateDbBatch()	Obsoleti. In caso di override in una classe derivata, restituisce una nuova istanza della classe del provider che implementa la DbBatch classe . (Ereditato da DbConnection)
CreateDbCommand()	Obsoleti. In caso di override in una classe derivata, crea e restituisce un oggetto DbCommand associato alla connessione corrente. (Ereditato da DbConnection)
CreateObjRef(Type)	Obsoleti. 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()	Obsoleti. Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite. (Ereditato da DbConnection)
Dispose(Boolean)	Obsoleti. Rilascia le risorse non gestite usate da DbConnection e, facoltativamente, le risorse gestite. (Ereditato da DbConnection)
DisposeAsync()	Obsoleti. Elimina in modo asincrono l'oggetto connessione. (Ereditato da DbConnection)
EnlistDistributedTransaction(ITransaction)	Obsoleti. Permette l'integrazione nella transazione specificata come transazione distribuita.
EnlistTransaction(Transaction)	Obsoleti. Permette l'integrazione nella transazione specificata come transazione distribuita.
Equals(Object)	Obsoleti. Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Obsoleti. Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetSchema()	Obsoleti. Restituisce informazioni sullo schema per l'origine dati di questo oggetto OracleConnection.
GetSchema(String)	Obsoleti. Restituisce le informazioni di schema per l'origine dati dell'oggetto OracleConnection usando la stringa specificata per il nome dello schema.
GetSchema(String, String[])	Obsoleti. Restituisce le informazioni di schema per l'origine dati dell'oggetto OracleConnection utilizzando la stringa specificata per il nome dello schema e la matrice di stringhe specificata per i valori di restrizione.
GetSchemaAsync(CancellationToken)	Obsoleti. 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)	Obsoleti. 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)	Obsoleti. 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)	Obsoleti. Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component)
GetType()	Obsoleti. Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Obsoleti. Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Obsoleti. Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Obsoleti. Genera l'evento StateChange. (Ereditato da DbConnection)
Open()	Obsoleti. Apre una connessione a un database con le impostazioni delle proprietà specificate dalla proprietà ConnectionString.
OpenAsync()	Obsoleti. 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)	Obsoleti. 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()	Obsoleti. 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	Obsoleti. Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (Ereditato da Component)
InfoMessage	Obsoleti. Viene generato quando si invia un avviso o un messaggio informativo mediante Oracle.
StateChange	Obsoleti. Si verifica quando cambia lo stato della connessione. (Ereditato da DbConnection)

Implementazioni dell'interfaccia esplicita

ICloneable.Clone()	Obsoleti. Crea un nuovo oggetto che è una copia dell'istanza corrente.
IDbConnection.BeginTransaction()	Obsoleti. Avvia una transazione di database. (Ereditato da DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Obsoleti. Inizia una transazione di database con il livello di isolamento specificato. (Ereditato da DbConnection)
IDbConnection.CreateCommand()	Obsoleti. Crea e restituisce un oggetto DbCommand associato alla connessione corrente. (Ereditato da DbConnection)

Vedi anche

• OracleDataAdapter
• OracleCommand