OracleConnection OracleConnection OracleConnection OracleConnection Class

Definition

Warnung

Diese API ist jetzt veraltet.

Stellt eine offene Verbindung mit einer Datenbank dar.Represents an open connection to a database. Diese Klasse kann nicht vererbt werden.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
Vererbung
Attribute
Implementiert

Beispiele

Das folgende Beispiel erstellt eine OracleCommand und ein OracleConnection.The following example creates an OracleCommand and an OracleConnection. Der OracleConnection wird geöffnet und OracleCommand.Connection als-Eigenschaft festgelegt.The OracleConnection is opened and set as the OracleCommand.Connection property. Im Beispiel wird dann ExecuteNonQueryaufgerufen, und die Verbindung wird geschlossen.The example then calls ExecuteNonQuery, and closes the connection. Zu diesem Zweck wird dem ExecuteNonQuery eine Verbindungs Zeichenfolge und eine Abfrage Zeichenfolge, die eine SQL INSERT-Anweisung ist, übermittelt.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

Hinweise

Dieser Typ ist veraltet und wird in einer zukünftigen Version des .NET Framework entfernt.This type is deprecated and will be removed in a future version of the .NET Framework. Weitere Informationen finden Sie unter Oracle und ADO.net.For more information, see Oracle and ADO.NET.

Ein OracleConnection -Objekt stellt eine eindeutige Verbindung mit einer Oracle-Datenbank dar.An OracleConnection object represents a unique connection to an Oracle database. Im Fall eines Client/Server-Datenbanksystems entspricht dies einer Netzwerkverbindung mit dem Server.In the case of a client/server database system, it is equivalent to a network connection to the server.

Eine Anwendung, die eine Instanz des OracleConnection -Objekts erstellt, kann deklarative oder imperative Sicherheitsanforderungen festlegen, die erfordern, dass alle direkten und indirekten Aufrufer über ausreichende Berechtigungen für den Code verfügen.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. OracleConnectionerstellt Sicherheitsanforderungen, indem das OraclePermission -Objekt verwendet wird.OracleConnection creates security demands by using the OraclePermission object. Benutzer können mithilfe des OraclePermissionAttribute -Objekts überprüfen, ob Ihr Code über ausreichende Berechtigungen verfügt.Users can verify that their code has adequate permissions by using the OraclePermissionAttribute object. Benutzer und Administratoren können auch das Sicherheitsrichtlinien Tool für den Code Zugriff (Caspol. exe) verwenden, um die Sicherheitsrichtlinien auf Computer-, Benutzer-und Unternehmensebene zu ändern.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. Weitere Informationen finden Sie unter Sicherheit (WPF).For more information, see Security.

Hinweis

Im Gegensatz zum Verbindungs Objekt in den anderen .NET Framework-Datenanbietern (SQL Server, OLE DB und ODBC) OracleConnection unterstützt ConnectionTimeout keine-Eigenschaft.Unlike the Connection object in the other .NET Framework data providers (SQL Server, OLE DB, and ODBC), OracleConnection does not support a ConnectionTimeout property. Das Festlegen eines Verbindungs Timeouts entweder als Eigenschaft oder in der Verbindungs Zeichenfolge hat keine Auswirkung, und der zurückgegebene Wert ist immer 0 (null).Setting a connection time-out either as a property or in the connection string has no effect, and the value returned is always zero. OracleConnectionunterstützt Database auch keine-Eigenschaft ChangeDatabase oder-Methode.OracleConnection also does not support a Database property or a ChangeDatabase method.

Wenn das OracleConnection Objekt den Gültigkeitsbereich verlässt, bleibt es geöffnet.If the OracleConnection object goes out of scope, it remains open. Daher sollten Sie Objekte immer schließen OracleConnection , indem Sie Close aufrufen oder löschen oder indemSie das OracleConnection -Objekt in Using einer-Anweisung verwenden.Therefore, you should always close OracleConnection objects by calling Close or Dispose, or by using the OracleConnection object within a Using statement. Andernfalls werden Sie vom Garbage Collection möglicherweise nicht sofort freigegeben.Otherwise, the garbage collection might not free them immediately. Solche Verzögerungen können zu Fehlern führen, wenn die maximale Anzahl von Verbindungen erreicht ist, während eine Anzahl von Verbindungen von der Garbage Collector gelöscht wird.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. Im Gegensatz dazu werden durch den Aufruf Close von Native Ressourcen effizienter verwendet, wodurch die Skalierbarkeit verbessert und die Gesamtleistung der Anwendung verbessert wird.By contrast, closing the connections by calling Close uses native resources more efficiently, enhancing scalability and improving overall application performance. Um sicherzustellen, dass Verbindungen immer geschlossen werden, öffnen Sie die Verbindung Using in einem-Block.To ensure that connections are always closed, open the connection inside of a Using block.

Hinweis

Zum Bereitstellen von Hochleistungsanwendungen müssen Sie häufig Verbindungspooling verwenden.To deploy high-performance applications, you often need to use connection pooling. Wenn Sie jedoch die .NET Framework Datenanbieter für Oracle verwenden, müssen Sie das Verbindungspooling nicht aktivieren, da der Anbieter dies automatisch verwaltet.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.

Konstruktoren

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

Initialisiert eine neue Instanz des OracleConnection.Initializes a new instance of the OracleConnection.

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

Initialisiert eine neue Instanz der OracleConnection-Klasse mit der angegebenen Verbindungszeichenfolge.Initializes a new instance of the OracleConnection class with the specified connection string.

Eigenschaften

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
ConnectionString ConnectionString ConnectionString ConnectionString

Ruft die Zeichenfolge ab, mit der eine Oracle-Datenbank geöffnet wird, oder legt diese fest.Gets or sets the string used to open an Oracle database.

ConnectionTimeout ConnectionTimeout ConnectionTimeout ConnectionTimeout

Ruft die Zeit ab, die beim Verbindungsaufbau gewartet werden soll, bis der Versuch beendet und ein Fehler generiert wird.Gets the time to wait to establish a connection before terminating the attempt and generating an error.

Container Container Container Container

Ruft den IContainer ab, der die Component enthält.Gets the IContainer that contains the Component.

(Inherited from Component)
Database Database Database Database

Ruft den Namen der aktuellen Datenbank oder der nach dem Öffnen einer Verbindung zu verwendenden Datenbank ab.Gets the name of the current database or the database to be used after a connection is opened.

DataSource DataSource DataSource DataSource

Ruft den Namen des Oracle-Servers ab, mit dem eine Verbindung hergestellt werden soll.Gets the name of the Oracle server to which to connect.

DesignMode DesignMode DesignMode DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
ServerVersion ServerVersion ServerVersion ServerVersion

Ruft eine Zeichenfolge mit der Version des Servers ab, mit der der Client verbunden ist.Gets a string containing the version of the server to which the client is connected.

Site Site Site Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Inherited from Component)
State State State State

Ruft den aktuellen Zustand der Verbindung ab.Gets the current state of the connection.

Methoden

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

Beginnt eine Transaktion an der Datenbank.Begins a transaction at the database.

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

Beginnt eine Transaktion an der Datenbank mit dem angegebenen IsolationLevel-Wert.Begins a transaction at the database with the specified IsolationLevel value.

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

Ändert die aktuelle Datenbank für eine offene OracleConnection.Changes the current database for an open OracleConnection.

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

Leert den Verbindungspool.Empties the connection pool.

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

Leert den der angegebenen Verbindung zugeordneten Verbindungspool.Empties the connection pool associated with the specified connection.

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

Schließt die Verbindung mit der Datenbank.Closes the connection to the database.

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

Erstellt ein OracleCommand-Objekt, das der OracleConnection zugeordnet ist, und gibt es zurück.Creates and returns an OracleCommand object associated with the OracleConnection.

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

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.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()

Gibt alle vom Component verwendeten Ressourcen frei.Releases all resources used by the Component.

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

Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.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)

Trägt sich in der angegebenen Transaktion als verteilte Transaktion ein.Enlists in the specified transaction as a distributed transaction.

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

Trägt sich in der angegebenen Transaktion als verteilte Transaktion ein.Enlists in the specified transaction as a distributed transaction.

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

Gibt Schemainformationen für die Datenquelle dieser OracleConnection zurück.Returns schema information for the data source of this OracleConnection.

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

Gibt Schemainformationen für die Datenquelle dieser OracleConnection mithilfe der angegebenen Zeichenfolge des Schemanamens zurück.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[])

Gibt Schemainformationen für die Datenquelle dieser OracleConnection mithilfe der angegebenen Zeichenfolge des Schemanamens und des angegebenen Zeichenfolgenarrays der Einschränkungswerte zurück.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)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

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

Öffnet eine Verbindung mit der Datenbank anhand der durch ConnectionString angegebenen Eigenschafteneinstellungen.Opens a connection to a database with the property settings specified by the ConnectionString.

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

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden).Returns a String containing the name of the Component, if any. Diese Methode darf nicht überschrieben werden.This method should not be overridden.

(Inherited from Component)

Ereignisse

Disposed Disposed Disposed Disposed

Tritt ein, wenn die Komponente durch einen Aufruf der Dispose()-Methode freigegeben wird.Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
InfoMessage InfoMessage InfoMessage InfoMessage

Tritt beim Senden von Warn- oder Informationsmeldungen durch Oracle ein.Occurs when Oracle sends a warning or an informational message.

StateChange StateChange StateChange StateChange

Tritt auf, wenn sich der Status der Verbindung ändert.Occurs when the state of the connection changes.

Explizite Schnittstellenimplementierungen

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

Erstellt ein neues Objekt, das eine Kopie der aktuellen Instanz darstellt.Creates a new object that is a copy of the current instance.

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

Beginnt eine Datenbanktransaktion.Begins a database transaction.

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

Beginnt eine Datenbanktransaktion mit dem angegebenen IsolationLevel-Wert.Begins a database transaction with the specified IsolationLevel value.

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

Ändert die aktuelle Datenbank für ein offenes Connection-Objekt.Changes the current database for an open Connection object.

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

Erstellt ein Command-Objekt, das der Verbindung zugeordnet ist, und gibt dieses zurück.Creates and returns a Command object that is associated with the connection.

Gilt für:

Siehe auch