OracleConnection OracleConnection OracleConnection OracleConnection Class

Definizione

Avviso

Questa API è ora obsoleta.

Rappresenta una connessione aperta a un database.Represents an open connection to a database. Questa classe non può essere ereditata.This class cannot be inherited.

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
type OracleConnection = class
    inherit DbConnection
    interface ICloneable
Public NotInheritable Class OracleConnection
Inherits DbConnection
Implements ICloneable
Ereditarietà
Attributi
Implementazioni

Esempi

Nell'esempio seguente vengono creati OracleCommand un oggetto OracleConnectione un oggetto.The following example creates an OracleCommand and an OracleConnection. Viene aperto e impostato OracleCommand.Connection come proprietà. OracleConnectionThe OracleConnection is opened and set as the OracleCommand.Connection property. Nell'esempio viene quindi ExecuteNonQuerychiamata e chiusa la connessione.The example then calls ExecuteNonQuery, and closes the connection. A tale scopo, ExecuteNonQuery viene passata una stringa di connessione e una stringa di query che è un'istruzione SQL INSERT.To accomplish this, the ExecuteNonQuery is passed a connection string and a query string that is an SQL INSERT statement.

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 del .NET Framework.This type is deprecated and will be removed in a future version of the .NET Framework. Per ulteriori informazioni, vedere Oracle e ADO.NET.For more information, see Oracle and ADO.NET.

Un OracleConnection oggetto rappresenta una connessione univoca a un database Oracle.An OracleConnection object represents a unique connection to an Oracle database. Nel caso di un sistema di database client/server, equivale a una connessione di rete al server.In the case of a client/server database system, it is equivalent to a network connection to the server.

Un'applicazione che crea un'istanza dell' OracleConnection oggetto può impostare richieste di sicurezza dichiarative o imperative che richiedono che tutti i chiamanti diretti e indiretti dispongano delle autorizzazioni appropriate per il codice.An application that creates an instance of the OracleConnection object can set declarative or imperative security demands that require all direct and indirect callers to have adequate permission to the code. OracleConnectioncrea richieste di sicurezza utilizzando l' OraclePermission oggetto.OracleConnection creates security demands by using the OraclePermission object. Gli utenti possono verificare che il codice disponga di autorizzazioni adeguate OraclePermissionAttribute utilizzando l'oggetto.Users can verify that their code has adequate permissions by using the OraclePermissionAttribute object. Gli utenti e gli amministratori possono inoltre utilizzare lo strumento criteri di sicurezza dall'accesso di codice (Caspol. exe) per modificare i criteri di sicurezza a livello di computer, di utente e di organizzazione.Users and administrators can also use the Code Access Security Policy Tool (Caspol.exe) to modify security policy at the machine, user, and enterprise levels. Per ulteriori informazioni, vedere Sicurezza.For more information, see Security.

Nota

Diversamente dall'oggetto Connection negli altri provider di dati .NET Framework (SQL Server, OLE DB e ODBC), OracleConnection non supporta una ConnectionTimeout proprietà.Unlike the Connection object in the other .NET Framework data providers (SQL Server, OLE DB, and ODBC), OracleConnection does not support a ConnectionTimeout property. L'impostazione di un timeout di connessione come proprietà o nella stringa di connessione non ha alcun effetto e il valore restituito è sempre zero.Setting a connection time-out either as a property or in the connection string has no effect, and the value returned is always zero. OracleConnectionnon supporta inoltre una Database proprietà o un ChangeDatabase metodo.OracleConnection also does not support a Database property or a ChangeDatabase method.

Se l' OracleConnection oggetto esce dall'ambito, rimane aperto.If the OracleConnection object goes out of scope, it remains open. Pertanto OracleConnection , è necessario chiudere sempre gli oggetti chiamando Close o Dispose o utilizzando l' **** OracleConnection oggetto all'interno di un' Using istruzione.Therefore, you should always close OracleConnection objects by calling Close or Dispose, or by using the OracleConnection object within a Using statement. In caso contrario, è possibile che il Garbage Collection non li liberi immediatamente.Otherwise, the garbage collection might not free them immediately. 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.Such delays can cause errors if the maximum number of connections is reached while a number of connections are waiting to be deleted by the 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.By contrast, closing the connections by calling Close uses native resources more efficiently, enhancing scalability and improving overall application performance. Per assicurarsi che le connessioni siano sempre chiuse, aprire la connessione all'interno Using di un blocco.To ensure that connections are always closed, open the connection inside of a Using block.

Nota

Per distribuire applicazioni a prestazioni elevate, è spesso necessario usare il pool di connessioni.To deploy high-performance applications, you often need to use connection pooling. Tuttavia, quando si usa il .NET Framework provider di dati per Oracle, non è necessario abilitare il pool di connessioni perché il provider lo gestisce automaticamente.However, when you use the .NET Framework Data Provider for Oracle, you do not need to enable connection pooling because the provider manages this automatically.

Costruttori

OracleConnection() OracleConnection() OracleConnection() OracleConnection()

Inizializza una nuova istanza dell'oggetto OracleConnection.Initializes a new instance of the OracleConnection.

OracleConnection(String) OracleConnection(String) OracleConnection(String) OracleConnection(String)

Inizializza una nuova istanza della classe OracleConnection con la stringa di connessione specificata.Initializes a new instance of the OracleConnection class with the specified connection string.

Proprietà

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
ConnectionString ConnectionString ConnectionString ConnectionString

Ottiene o imposta la stringa utilizzata per aprire un database Oracle.Gets or sets the string used to open an Oracle database.

ConnectionTimeout ConnectionTimeout ConnectionTimeout ConnectionTimeout

Ottiene il tempo di attesa per stabilire una connessione, prima di terminare il tentativo e generare un errore.Gets the time to wait to establish a connection before terminating the attempt and generating an error.

Container Container Container Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the Component.

(Inherited from Component)
Database Database Database Database

Ottiene il nome del database corrente o del database da usare dopo l'apertura della connessione.Gets the name of the current database or the database to be used after a connection is opened.

DataSource DataSource DataSource DataSource

Ottiene il nome del server Oracle a cui effettuare la connessione.Gets the name of the Oracle server to which to connect.

DesignMode DesignMode DesignMode DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
ServerVersion ServerVersion ServerVersion ServerVersion

Ottiene una stringa che contiene la versione del server a cui è connesso il client.Gets a string containing the version of the server to which the client is connected.

Site Site Site Site

Ottiene o imposta l'oggetto ISite di Component.Gets or sets the ISite of the Component.

(Inherited from Component)
State State State State

Ottiene lo stato corrente della connessione.Gets the current state of the connection.

Metodi

BeginTransaction() BeginTransaction() BeginTransaction() BeginTransaction()

Avvia una transazione nel database.Begins a transaction at the database.

BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel) BeginTransaction(IsolationLevel)

Avvia una transazione nel database con il valore di IsolationLevel specificato.Begins a transaction at the database with the specified IsolationLevel value.

ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String) ChangeDatabase(String)

Modifica il database corrente per un oggetto OracleConnection aperto.Changes the current database for an open OracleConnection.

ClearAllPools() ClearAllPools() ClearAllPools() ClearAllPools()

Svuota il pool di connessioni.Empties the connection pool.

ClearPool(OracleConnection) ClearPool(OracleConnection) ClearPool(OracleConnection) ClearPool(OracleConnection)

Svuota il pool di connessioni associato alla connessione specificata.Empties the connection pool associated with the specified connection.

Close() Close() Close() Close()

Chiude la connessione al database.Closes the connection to the database.

CreateCommand() CreateCommand() CreateCommand() CreateCommand()

Crea e restituisce un oggetto OracleCommand associato alla classe OracleConnection.Creates and returns an OracleCommand object associated with the OracleConnection.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
EnlistDistributedTransaction(ITransaction) EnlistDistributedTransaction(ITransaction) EnlistDistributedTransaction(ITransaction) EnlistDistributedTransaction(ITransaction)

Permette l'integrazione nella transazione specificata come transazione distribuita.Enlists in the specified transaction as a distributed transaction.

EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction) EnlistTransaction(Transaction)

Permette l'integrazione nella transazione specificata come transazione distribuita.Enlists in the specified transaction as a distributed transaction.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetSchema() GetSchema() GetSchema() GetSchema()

Restituisce informazioni sullo schema per l'origine dati di questo oggetto OracleConnection.Returns schema information for the data source of this OracleConnection.

GetSchema(String) GetSchema(String) GetSchema(String) GetSchema(String)

Restituisce le informazioni di schema per l'origine dati dell'oggetto OracleConnection usando la stringa specificata per il nome dello schema.Returns schema information for the data source of this OracleConnection using the specified string for the schema name.

GetSchema(String, String[]) GetSchema(String, String[]) GetSchema(String, String[]) GetSchema(String, String[])

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.Returns schema information for the data source of this OracleConnection using the specified string for the schema name and the specified string array for the restriction values.

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Open() Open() Open() Open()

Apre una connessione a un database con le impostazioni delle proprietà specificate dalla proprietà ConnectionString.Opens a connection to a database with the property settings specified by the ConnectionString.

ToString() ToString() ToString() ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component.Returns a String containing the name of the Component, if any. Questo metodo non deve essere sottoposto a override.This method should not be overridden.

(Inherited from Component)

Eventi

Disposed Disposed Disposed Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
InfoMessage InfoMessage InfoMessage InfoMessage

Viene generato quando si invia un avviso o un messaggio informativo mediante Oracle.Occurs when Oracle sends a warning or an informational message.

StateChange StateChange StateChange StateChange

Si verifica quando cambia lo stato della connessione.Occurs when the state of the connection changes.

Implementazioni dell'interfaccia esplicita

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()

Crea un nuovo oggetto che è una copia dell'istanza corrente.Creates a new object that is a copy of the current instance.

IDbConnection.BeginTransaction() IDbConnection.BeginTransaction() IDbConnection.BeginTransaction() IDbConnection.BeginTransaction()

Avvia una transazione di database.Begins a database transaction.

IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel) IDbConnection.BeginTransaction(IsolationLevel)

Avvia una transazione di database con il valore specificato di IsolationLevel.Begins a database transaction with the specified IsolationLevel value.

IDbConnection.ChangeDatabase(String) IDbConnection.ChangeDatabase(String) IDbConnection.ChangeDatabase(String) IDbConnection.ChangeDatabase(String)

Cambia il database corrente per un oggetto Connection aperto.Changes the current database for an open Connection object.

IDbConnection.CreateCommand() IDbConnection.CreateCommand() IDbConnection.CreateCommand() IDbConnection.CreateCommand()

Crea e restituisce un oggetto Command associato alla connessione.Creates and returns a Command object that is associated with the connection.

Si applica a

Vedi anche