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

L'esempio seguente crea un OracleCommand e un OracleConnection.The following example creates an OracleCommand and an OracleConnection. Il OracleConnection viene aperto e impostare come il OracleCommand.Connection proprietà.The OracleConnection is opened and set as the OracleCommand.Connection property. Nell'esempio viene quindi chiamato ExecuteNonQuerye chiude la connessione.The example then calls ExecuteNonQuery, and closes the connection. A tale scopo, il ExecuteNonQuery viene passata una stringa di connessione e una stringa di query che rappresenta 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à rimossa in una futura versione di .NET Framework.This type is deprecated and will be removed in a future version of the .NET Framework. Per altre informazioni, vedere Oracle e ADO.NET.For more information, see Oracle and ADO.NET.

Un OracleConnection oggetto rappresenta una connessione univoca in un database Oracle.An OracleConnection object represents a unique connection to an Oracle database. Nel caso di un sistema di database client/server, è equivalente 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 di OracleConnection oggetto impostabile richieste di sicurezza dichiarativo o imperativo che richiedono tutti i chiamanti diretti e indiretti disponga delle autorizzazioni adeguate 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. OracleConnection Crea le richieste di sicurezza utilizzando il OraclePermission oggetto.OracleConnection creates security demands by using the OraclePermission object. Gli utenti possono verificare che il proprio codice concesse autorizzazioni adeguate usando il OraclePermissionAttribute oggetto.Users can verify that their code has adequate permissions by using the OraclePermissionAttribute object. Utenti e amministratori possono inoltre utilizzare lo strumento Code Access Security Policy (Caspol.exe) per modificare i criteri di sicurezza a livello aziendale, utente e computer.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

A differenza di Connection oggetto in altri provider di dati .NET Framework (SQL Server, OLE DB e ODBC), OracleConnection non supporta un 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 una 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. OracleConnection non supporta inoltre un Database proprietà o un ChangeDatabase (metodo).OracleConnection also does not support a Database property or a ChangeDatabase method.

Se il OracleConnection oggetto esce dall'ambito, rimane aperto.If the OracleConnection object goes out of scope, it remains open. Pertanto, è necessario chiuderla sempre OracleConnection gli oggetti chiamando Close o Dispose, o utilizzando il OracleConnection dell'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, l'operazione di garbage collection potrebbe liberazione non immediatamente.Otherwise, the garbage collection might not free them immediately. Questi ritardi possono causare errori se viene raggiunto il numero massimo di connessioni, mentre un numero di connessioni è in attesa di essere eliminata 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 utilizza le risorse native in modo più efficiente, migliorare 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 garantire che le connessioni sono sempre chiusi, aprire la connessione all'interno di un Using 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 pool di connessioni.To deploy high-performance applications, you often need to use connection pooling. Tuttavia, quando si usa il Provider di dati .NET Framework per Oracle, è necessario abilitare perché il provider gestisce automaticamente questo pool di connessioni.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 connettersi.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 il client è connesso.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()

Inizia una transazione a livello di database.Begins a transaction at the database.

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

Inizia una transazione a livello di database con l'oggetto specificato IsolationLevel valore.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à specificati da di 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

Si verifica quando Oracle invia un avviso o un messaggio informativo.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