Condividi tramite

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. Questa classe non può essere ereditata.

public ref class OracleConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection
public ref class OracleConnection sealed : System::Data::Common::DbConnection, ICloneable
public sealed class OracleConnection : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbConnection
public sealed class OracleConnection : 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
type OracleConnection = class
    inherit Component
    interface ICloneable
    interface IDbConnection
    interface IDisposable
type OracleConnection = class
    inherit DbConnection
    interface 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 Component
Implements ICloneable, IDbConnection, IDisposable
Public NotInheritable Class OracleConnection
Inherits DbConnection
Implements ICloneable
Ereditarietà
Object
MarshalByRefObject
Component
OracleConnection
Ereditarietà
Object
MarshalByRefObject
Component
DbConnection
OracleConnection
Attributi
ObsoleteAttribute
Implementazioni
IDbConnection ICloneable IDisposable

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 per l'accesso di codice (Caspol.exe) per modificare i criteri di sicurezza a livello di computer, utente e organizzazione. Per altre informazioni, vedere Security.

Annotazioni

A differenza dell'oggetto Connection negli altri provider di dati .NET Framework (SQL Server, OLE DB e ODBC), OracleConnection non supporta una ConnectionTimeout proprietà . L'impostazione di un timeout della connessione come proprietà o nella stringa di connessione non ha alcun effetto e il valore restituito è sempre zero. OracleConnection non supporta anche una Database proprietà o un ChangeDatabase 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, il Garbage Collection potrebbe non liberarli immediatamente. Tali ritardi possono causare errori se viene raggiunto il numero massimo di connessioni mentre un numero di connessioni è in attesa di essere eliminato dal Garbage Collector. Al contrario, la chiusura delle 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.

Annotazioni

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

Nome Descrizione
OracleConnection()
Obsoleti.

Inizializza una nuova istanza di OracleConnection.
OracleConnection(String)
Obsoleti.

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

Proprietà

Nome Descrizione
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 contenente l'oggetto Component.

(Ereditato da Component)
Database
Obsoleti.

Ottiene il nome del database corrente o del database da utilizzare dopo l'apertura di una connessione.
DataSource
Obsoleti.

Ottiene il nome del server Oracle a cui connettersi.
DbProviderFactory
Obsoleti.

Ottiene l'oggetto per l'oggetto DbProviderFactoryDbConnection.

(Ereditato da DbConnection)
DesignMode
Obsoleti.

Ottiene un valore che indica se è Component attualmente in modalità progettazione.

(Ereditato da Component)
Events
Obsoleti.

Ottiene l'elenco dei gestori eventi associati a questo Componentoggetto .

(Ereditato da Component)
ServerVersion
Obsoleti.

Ottiene una stringa contenente la versione del server a cui è connesso il client.
Site
Obsoleti.

Ottiene o imposta l'oggetto ISite dell'oggetto Component.

(Ereditato da Component)
State
Obsoleti.

Ottiene lo stato corrente della connessione.

Metodi

Nome Descrizione
BeginDbTransaction(IsolationLevel)
Obsoleti.

Quando sottoposto a override in una classe derivata, avvia una transazione di database.

(Ereditato da DbConnection)
BeginTransaction()
Obsoleti.

Avvia una transazione nel database.
BeginTransaction(IsolationLevel)
Obsoleti.

Avvia una transazione nel database con il valore specificato IsolationLevel .
ChangeDatabase(String)
Obsoleti.

Modifica il database corrente per un oggetto aperto OracleConnection.
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.
CreateCommand()
Obsoleti.

Crea e restituisce un OracleCommand oggetto associato all'oggetto OracleConnection.
CreateDbCommand()
Obsoleti.

Quando sottoposto a override in una classe derivata, crea e restituisce un DbCommand oggetto associato alla connessione corrente.

(Ereditato da DbConnection)
CreateObjRef(Type)
Obsoleti.

Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto.

(Ereditato da MarshalByRefObject)
Dispose()
Obsoleti.

Rilascia tutte le risorse usate da Component.

(Ereditato da Component)
Dispose(Boolean)
Obsoleti.

Rilascia le risorse non gestite usate da Component e, facoltativamente, rilascia le risorse gestite.

(Ereditato da Component)
EnlistDistributedTransaction(ITransaction)
Obsoleti.

Integra la transazione specificata come transazione distribuita.
EnlistTransaction(Transaction)
Obsoleti.

Integra la 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()
Obsoleti.

Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza.

(Ereditato da MarshalByRefObject)
GetSchema()
Obsoleti.

Restituisce informazioni sullo schema per l'origine dati di questo OracleConnectionoggetto .
GetSchema(String, String[])
Obsoleti.

Restituisce informazioni sullo schema per l'origine dati di utilizzando OracleConnection la stringa specificata per il nome dello schema e la matrice di stringhe specificata per i valori di restrizione.
GetSchema(String)
Obsoleti.

Restituisce informazioni sullo schema per l'origine dati di utilizzando OracleConnection la stringa specificata per il nome dello schema.
GetService(Type)
Obsoleti.

Restituisce un oggetto che rappresenta un servizio fornito da Component o da Container.

(Ereditato da Component)
GetType()
Obsoleti.

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
InitializeLifetimeService()
Obsoleti.

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.

(Ereditato da MarshalByRefObject)
MemberwiseClone()
Obsoleti.

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
MemberwiseClone(Boolean)
Obsoleti.

Crea una copia superficiale dell'oggetto corrente MarshalByRefObject .

(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 da ConnectionString.
OpenAsync()
Obsoleti.

Versione asincrona di , che apre una connessione di Open()database con le impostazioni specificate da ConnectionString. Questo metodo richiama il metodo OpenAsync(CancellationToken) virtuale 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ò essere facoltativamente rispettato.

L'implementazione predefinita richiama la chiamata sincrona Open() e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se è stato passato un oggetto cancellationToken già annullato. Le eccezioni generate da Open verranno comunicate tramite la proprietà Task Exception restituita.

Non richiamare altri metodi e proprietà dell'oggetto DbConnection fino al completamento dell'attività restituita.

(Ereditato da DbConnection)
ToString()
Obsoleti.

Restituisce un oggetto String contenente il nome dell'oggetto Component, se presente. Questo metodo non deve essere sottoposto a override.

(Ereditato da Component)

Eventi

Nome Descrizione
Disposed
Obsoleti.

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

(Ereditato da Component)
InfoMessage
Obsoleti.

Si verifica quando Oracle invia un avviso o un messaggio informativo.
StateChange
Obsoleti.

Si verifica quando lo stato della connessione cambia.
StateChange
Obsoleti.

Si verifica quando lo stato della connessione cambia.

(Ereditato da DbConnection)

Implementazioni dell'interfaccia esplicita

Nome Descrizione
ICloneable.Clone()
Obsoleti.

Crea un nuovo oggetto che rappresenta una copia dell'istanza corrente.
IDbConnection.BeginTransaction()
Obsoleti.

Avvia una transazione di database.
IDbConnection.BeginTransaction()
Obsoleti.

Avvia una transazione di database.

(Ereditato da DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)
Obsoleti.

Avvia una transazione di database con il valore specificato IsolationLevel .
IDbConnection.BeginTransaction(IsolationLevel)
Obsoleti.

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

(Ereditato da DbConnection)
IDbConnection.ChangeDatabase(String)
Obsoleti.

Modifica il database corrente per un oggetto Connection aperto.
IDbConnection.CreateCommand()
Obsoleti.

Crea e restituisce un oggetto Command associato alla connessione.
IDbConnection.CreateCommand()
Obsoleti.

Crea e restituisce un DbCommand oggetto associato alla connessione corrente.

(Ereditato da DbConnection)

Si applica a

Vedi anche