OracleConnection Třída

Definice

Obor názvů:

System.Data.OracleClient

Sestavení:

System.Data.OracleClient.dll

Upozornění

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

Představuje otevřené připojení k databázi. Tato třída se nemůže dědit.

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

Dědičnost

Object

MarshalByRefObject

Component

DbConnection

OracleConnection

Atributy

ObsoleteAttribute

Implementuje

ICloneable

Příklady

Následující příklad vytvoří a OracleCommandOracleConnection. Otevře OracleConnection se a nastaví jako OracleCommand.Connection vlastnost. Příklad pak zavolá ExecuteNonQuerya ukončí připojení. Za tímto účelem ExecuteNonQuery se předá připojovací řetězec a řetězec dotazu, který je příkazem 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

Poznámky

Tento typ je zastaralý a bude odebrán v budoucí verzi rozhraní .NET Framework. Další informace najdete v tématu Oracle a ADO.NET.

Objekt OracleConnection představuje jedinečné připojení k databázi Oracle. V případě databázového systému klient/server je ekvivalentem síťového připojení k serveru.

Aplikace, která vytvoří instanci objektu OracleConnection , může nastavit deklarativní nebo imperativní požadavky na zabezpečení, které vyžadují, aby všichni přímí i nepřímí volající měli odpovídající oprávnění ke kódu. OracleConnection vytváří požadavky na zabezpečení pomocí objektu OraclePermission . Uživatelé můžou pomocí objektu OraclePermissionAttribute ověřit, že jejich kód má odpovídající oprávnění. Uživatelé a správci můžou také pomocí nástroje Code Access Security Policy Tool (Caspol.exe) upravovat zásady zabezpečení na úrovni počítače, uživatele a organizace. Další informace najdete v tématu Zabezpečení.

Poznámka

Na rozdíl od objektu Connection v jiných zprostředkovatelích dat rozhraní .NET Framework (SQL Server, OLE DB a ODBC) OracleConnection nepodporuje ConnectionTimeout vlastnost. Nastavení časového limitu připojení jako vlastnosti nebo v připojovacím řetězci nemá žádný vliv a vrácená hodnota je vždy nulová. OracleConnection nepodporuje Database ani vlastnost nebo metodu ChangeDatabase .

OracleConnection Pokud objekt překročí rozsah, zůstane otevřený. Proto byste měli objekty vždy zavřít OracleConnection voláním Close nebo dispose, nebo pomocí objektu OracleConnection v rámci Using příkazu. V opačném případě by je uvolňování paměti nemuselo okamžitě uvolnit. Taková zpoždění můžou způsobit chyby, pokud je dosaženo maximálního počtu připojení, zatímco několik připojení čeká na odstranění ze systému uvolňování paměti. Naproti tomu uzavření připojení voláním Close využívá nativní prostředky efektivněji, zvyšuje škálovatelnost a zlepšuje celkový výkon aplikace. Chcete-li zajistit, aby připojení byla vždy uzavřena, otevřete připojení uvnitř Using bloku.

Poznámka

K nasazení vysoce výkonných aplikací často potřebujete použít sdružování připojení. Pokud ale použijete zprostředkovatele dat .NET Framework pro Oracle, není nutné povolit sdružování připojení, protože zprostředkovatel ho spravuje automaticky.

Konstruktory

OracleConnection()	Zastaralé. Inicializuje novou instanci objektu OracleConnection.
OracleConnection(String)	Zastaralé. Inicializuje novou instanci OracleConnection třídy se zadaným připojovacím řetězcem.

Vlastnosti

CanCreateBatch	Zastaralé. Získá hodnotu, která označuje, zda tato DbConnection instance podporuje DbBatch třídu . (Zděděno od DbConnection)
CanRaiseEvents	Zastaralé. Získá hodnotu označující, zda komponenta může vyvolat událost. (Zděděno od Component)
ConnectionString	Zastaralé. Získá nebo nastaví řetězec použitý k otevření databáze Oracle.
ConnectionTimeout	Zastaralé. Získá dobu čekání na navázání připojení před ukončením pokusu a generováním chyby.
Container	Zastaralé. Získá objekt IContainer , který obsahuje Component. (Zděděno od Component)
Database	Zastaralé. Získá název aktuální databáze nebo databáze, která má být použita po otevření připojení.
DataSource	Zastaralé. Získá název serveru Oracle, ke kterému se chcete připojit.
DbProviderFactory	Zastaralé. Získá pro DbProviderFactory tento DbConnectionobjekt . (Zděděno od DbConnection)
DesignMode	Zastaralé. Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component)
Events	Zastaralé. Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
ServerVersion	Zastaralé. Získá řetězec obsahující verzi serveru, ke kterému je klient připojen.
Site	Zastaralé. Získá nebo nastaví ISite z Component. (Zděděno od Component)
State	Zastaralé. Získá aktuální stav připojení.

Metody

BeginDbTransaction(IsolationLevel)	Zastaralé. Při přepsání v odvozené třídě spustí transakci databáze. (Zděděno od DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Zastaralé. Asynchronně spustí transakci databáze. (Zděděno od DbConnection)
BeginTransaction()	Zastaralé. Zahájí transakci v databázi.
BeginTransaction(IsolationLevel)	Zastaralé. Transakce začíná v databázi se zadanou IsolationLevel hodnotou.
BeginTransactionAsync(CancellationToken)	Zastaralé. Asynchronně zahájí transakci databáze. (Zděděno od DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Zastaralé. Asynchronně zahájí transakci databáze. (Zděděno od DbConnection)
ChangeDatabase(String)	Zastaralé. Změní aktuální databázi otevřeného objektu OracleConnection.
ChangeDatabaseAsync(String, CancellationToken)	Zastaralé. Asynchronně změní aktuální databázi pro otevřené připojení. (Zděděno od DbConnection)
ClearAllPools()	Zastaralé. Vyprázdní fond připojení.
ClearPool(OracleConnection)	Zastaralé. Vyprázdní fond připojení přidružený k zadanému připojení.
Close()	Zastaralé. Ukončí připojení k databázi.
CloseAsync()	Zastaralé. Asynchronně ukončí připojení k databázi. (Zděděno od DbConnection)
CreateBatch()	Zastaralé. Vrátí novou instanci třídy zprostředkovatele, která implementuje DbBatch třídu . (Zděděno od DbConnection)
CreateCommand()	Zastaralé. Vytvoří a vrátí OracleCommand objekt přidružený k objektu OracleConnection.
CreateDbBatch()	Zastaralé. Při přepsání v odvozené třídě vrátí novou instanci třídy zprostředkovatele, která implementuje DbBatch třídu . (Zděděno od DbConnection)
CreateDbCommand()	Zastaralé. Při přepsání v odvozené třídě vytvoří a vrátí DbCommand objekt přidružený k aktuálnímu připojení. (Zděděno od DbConnection)
CreateObjRef(Type)	Zastaralé. Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Zastaralé. Provede aplikací definované úlohy spojené s uvolněním nebo resetováním nespravovaných prostředků. (Zděděno od DbConnection)
Dispose(Boolean)	Zastaralé. Uvolní nespravované prostředky používané nástrojem DbConnection a volitelně uvolní spravované prostředky. (Zděděno od DbConnection)
DisposeAsync()	Zastaralé. Asynchronně rozloží objekt připojení. (Zděděno od DbConnection)
EnlistDistributedTransaction(ITransaction)	Zastaralé. Zadává v zadané transakci jako distribuovanou transakci.
EnlistTransaction(Transaction)	Zastaralé. Zadává v zadané transakci jako distribuovanou transakci.
Equals(Object)	Zastaralé. Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Zastaralé. Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetSchema()	Zastaralé. Vrátí informace o schématu pro zdroj dat tohoto OracleConnection.
GetSchema(String)	Zastaralé. Vrátí informace o schématu pro zdroj dat tohoto OracleConnection typu pomocí zadaného řetězce pro název schématu.
GetSchema(String, String[])	Zastaralé. Vrátí informace o schématu pro zdroj dat tohoto OracleConnection typu pomocí zadaného řetězce pro název schématu a zadaného pole řetězců pro hodnoty omezení.
GetSchemaAsync(CancellationToken)	Zastaralé. Toto je asynchronní verze nástroje GetSchema(). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně cancellationToken může být respektována. Výchozí implementace vyvolá synchronní GetSchema() volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud byla předána již zrušená cancellationTokenúloha . Výjimky vyvolané nástrojem GetSchema() budou oznámeny prostřednictvím vrácené vlastnosti Task Exception (Výjimka úkolu). (Zděděno od DbConnection)
GetSchemaAsync(String, CancellationToken)	Zastaralé. Toto je asynchronní verze nástroje GetSchema(String). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně cancellationToken může být respektována. Výchozí implementace vyvolá synchronní GetSchema(String) volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud byla předána již zrušená cancellationTokenúloha . Výjimky vyvolané nástrojem GetSchema(String) budou oznámeny prostřednictvím vrácené vlastnosti Task Exception (Výjimka úkolu). (Zděděno od DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Zastaralé. Toto je asynchronní verze nástroje GetSchema(String, String[]). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně cancellationToken může být respektována. Výchozí implementace vyvolá synchronní GetSchema(String, String[]) volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud byla předána již zrušená cancellationTokenúloha . Výjimky vyvolané nástrojem GetSchema(String, String[]) budou oznámeny prostřednictvím vrácené vlastnosti Task Exception (Výjimka úkolu). (Zděděno od DbConnection)
GetService(Type)	Zastaralé. Vrátí objekt, který představuje službu poskytovanou objektem Component nebo .Container (Zděděno od Component)
GetType()	Zastaralé. Získá aktuální Type instanci. (Zděděno od Object)
InitializeLifetimeService()	Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Zastaralé. Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Zastaralé. Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Zastaralé. StateChange Vyvolá událost. (Zděděno od DbConnection)
Open()	Zastaralé. Otevře připojení k databázi s nastavením vlastnosti určeným parametrem ConnectionString.
OpenAsync()	Zastaralé. Asynchronní verze nástroje Open(), která otevře připojení k databázi s nastavením určeným parametrem ConnectionString. Tato metoda vyvolá virtuální metodu OpenAsync(CancellationToken) pomocí CancellationToken.None. (Zděděno od DbConnection)
OpenAsync(CancellationToken)	Zastaralé. Toto je asynchronní verze nástroje Open(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení je možné volitelně respektovat. Výchozí implementace vyvolá synchronní Open() volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud je předán již zrušený cancellationToken. Výjimky vyvolané otevřením budou oznámeny prostřednictvím vrácené vlastnosti Task Exception (Výjimka úlohy). Nevyvolávej jiné metody a vlastnosti objektu DbConnection , dokud vrácená úloha není dokončena. (Zděděno od DbConnection)
ToString()	Zastaralé. String Vrátí hodnotu obsahující název , Componentpokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)

Událost

Disposed	Zastaralé. Vyvolá se, když je komponenta uvolněna voláním Dispose() metody . (Zděděno od Component)
InfoMessage	Zastaralé. Nastane, když Oracle odešle upozornění nebo informační zprávu.
StateChange	Zastaralé. Vyvolá se při změně stavu připojení. (Zděděno od DbConnection)

Explicitní implementace rozhraní

ICloneable.Clone()	Zastaralé. Vytváří nový objekt, který je kopií aktuální instance.
IDbConnection.BeginTransaction()	Zastaralé. Zahájí transakci databáze. (Zděděno od DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Zastaralé. Začíná databázovou transakci se zadanou úrovní izolace. (Zděděno od DbConnection)
IDbConnection.CreateCommand()	Zastaralé. Vytvoří a vrátí DbCommand objekt, který je přidružen k aktuálnímu připojení. (Zděděno od DbConnection)

Viz také

• OracleDataAdapter
• OracleCommand