OracleConnection Kelas

Definisi

Ruang nama:

System.Data.OracleClient

Rakitan:

System.Data.OracleClient.dll

Perhatian

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

Mewakili koneksi terbuka ke database. Kelas ini tidak dapat diwariskan.

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

Warisan

Object

MarshalByRefObject

Component

DbConnection

OracleConnection

Atribut

ObsoleteAttribute

Penerapan

ICloneable

Contoh

Contoh berikut membuat OracleCommand dan OracleConnection. OracleConnection dibuka dan ditetapkan sebagai OracleCommand.Connection properti . Contoh kemudian memanggil ExecuteNonQuery, dan menutup koneksi. Untuk mencapai hal ini, ExecuteNonQuery diteruskan string koneksi dan string kueri yang merupakan pernyataan 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

Keterangan

Jenis ini tidak digunakan lagi dan akan dihapus dalam versi .NET Framework yang akan datang. Untuk informasi selengkapnya, lihat Oracle dan ADO.NET.

Objek OracleConnection mewakili koneksi unik ke database Oracle. Dalam kasus sistem database klien/server, itu setara dengan koneksi jaringan ke server.

Aplikasi yang membuat instans OracleConnection objek dapat mengatur tuntutan keamanan deklaratif atau imperatif yang mengharuskan semua penelepon langsung dan tidak langsung memiliki izin yang memadai ke kode. OracleConnection membuat tuntutan keamanan dengan menggunakan OraclePermission objek . Pengguna dapat memverifikasi bahwa kode mereka memiliki izin yang memadai dengan menggunakan OraclePermissionAttribute objek . Pengguna dan administrator juga dapat menggunakan Alat Kebijakan Keamanan Akses Kode (Caspol.exe) untuk memodifikasi kebijakan keamanan di tingkat mesin, pengguna, dan perusahaan. Untuk informasi selengkapnya, lihat Keamanan.

Catatan

Tidak seperti objek Koneksi di penyedia data .NET Framework lainnya (SQL Server, OLE DB, dan ODBC), OracleConnection tidak mendukung ConnectionTimeout properti. Mengatur batas waktu koneksi baik sebagai properti atau dalam string koneksi tidak berpengaruh, dan nilai yang dikembalikan selalu nol. OracleConnection juga tidak mendukung Database properti atau ChangeDatabase metode .

OracleConnection Jika objek keluar dari cakupan, objek tetap terbuka. Oleh karena itu, Anda harus selalu menutup OracleConnection objek dengan memanggil Close atau Membuang, atau dengan menggunakan OracleConnection objek dalam Using pernyataan. Jika tidak, pengumpulan sampah mungkin tidak segera membebaskannya. Penundaan tersebut dapat menyebabkan kesalahan jika jumlah maksimum koneksi tercapai saat sejumlah koneksi menunggu untuk dihapus oleh pengumpul sampah. Sebaliknya, menutup koneksi dengan memanggil Close menggunakan sumber daya asli secara lebih efisien, meningkatkan skalabilitas dan meningkatkan performa aplikasi secara keseluruhan. Untuk memastikan bahwa koneksi selalu ditutup, buka koneksi di dalam Using blok.

Catatan

Untuk menyebarkan aplikasi berkinerja tinggi, Anda sering kali perlu menggunakan pengumpulan koneksi. Namun, ketika Anda menggunakan Penyedia Data .NET Framework untuk Oracle, Anda tidak perlu mengaktifkan pengumpulan koneksi karena penyedia mengelolanya secara otomatis.

Konstruktor

OracleConnection()	Kedaluwarsa. Menginisialisasi instans baru dari OracleConnection.
OracleConnection(String)	Kedaluwarsa. Menginisialisasi instans OracleConnection baru kelas dengan string koneksi yang ditentukan.

Properti

CanCreateBatch	Kedaluwarsa. Mendapatkan nilai yang menunjukkan apakah instans DbBatch ini DbConnection mendukung kelas . (Diperoleh dari DbConnection)
CanRaiseEvents	Kedaluwarsa. Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
ConnectionString	Kedaluwarsa. Mendapatkan atau mengatur string yang digunakan untuk membuka database Oracle.
ConnectionTimeout	Kedaluwarsa. Mendapatkan waktu untuk menunggu untuk membuat koneksi sebelum mengakhiri upaya dan menghasilkan kesalahan.
Container	Kedaluwarsa. IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component)
Database	Kedaluwarsa. Mendapatkan nama database saat ini atau database yang akan digunakan setelah koneksi dibuka.
DataSource	Kedaluwarsa. Mendapatkan nama server Oracle yang akan disambungkan.
DbProviderFactory	Kedaluwarsa. DbProviderFactory Mendapatkan untuk iniDbConnection. (Diperoleh dari DbConnection)
DesignMode	Kedaluwarsa. Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component)
Events	Kedaluwarsa. Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component)
ServerVersion	Kedaluwarsa. Mendapatkan string yang berisi versi server tempat klien terhubung.
Site	Kedaluwarsa. Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component)
State	Kedaluwarsa. Mendapatkan status koneksi saat ini.

Metode

BeginDbTransaction(IsolationLevel)	Kedaluwarsa. Saat ditimpa di kelas turunan, memulai transaksi database. (Diperoleh dari DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Kedaluwarsa. Secara asinkron memulai transaksi database. (Diperoleh dari DbConnection)
BeginTransaction()	Kedaluwarsa. Memulai transaksi di database.
BeginTransaction(IsolationLevel)	Kedaluwarsa. Memulai transaksi di database dengan nilai yang ditentukan IsolationLevel .
BeginTransactionAsync(CancellationToken)	Kedaluwarsa. Secara asinkron memulai transaksi database. (Diperoleh dari DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Kedaluwarsa. Secara asinkron memulai transaksi database. (Diperoleh dari DbConnection)
ChangeDatabase(String)	Kedaluwarsa. Mengubah database saat ini untuk membuka OracleConnection.
ChangeDatabaseAsync(String, CancellationToken)	Kedaluwarsa. Secara asinkron mengubah database saat ini untuk koneksi terbuka. (Diperoleh dari DbConnection)
ClearAllPools()	Kedaluwarsa. Mengikat kumpulan koneksi.
ClearPool(OracleConnection)	Kedaluwarsa. Mengolah kumpulan koneksi yang terkait dengan koneksi yang ditentukan.
Close()	Kedaluwarsa. Menutup koneksi ke database.
CloseAsync()	Kedaluwarsa. Secara asinkron menutup koneksi ke database. (Diperoleh dari DbConnection)
CreateBatch()	Kedaluwarsa. Mengembalikan instans baru kelas penyedia yang mengimplementasikan DbBatch kelas . (Diperoleh dari DbConnection)
CreateCommand()	Kedaluwarsa. Membuat dan mengembalikan objek yang OracleCommand terkait dengan OracleConnection.
CreateDbBatch()	Kedaluwarsa. Saat ditimpa di kelas turunan, mengembalikan instans baru kelas penyedia yang mengimplementasikan DbBatch kelas . (Diperoleh dari DbConnection)
CreateDbCommand()	Kedaluwarsa. Saat ditimpa di kelas turunan, membuat dan mengembalikan objek yang DbCommand terkait dengan koneksi saat ini. (Diperoleh dari DbConnection)
CreateObjRef(Type)	Kedaluwarsa. Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Kedaluwarsa. Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, melepaskan, atau mereset sumber daya yang tidak terkelola. (Diperoleh dari DbConnection)
Dispose(Boolean)	Kedaluwarsa. Merilis sumber daya tidak terkelola yang DbConnection digunakan oleh dan secara opsional merilis sumber daya terkelola. (Diperoleh dari DbConnection)
DisposeAsync()	Kedaluwarsa. Membuang objek koneksi secara asinkron. (Diperoleh dari DbConnection)
EnlistDistributedTransaction(ITransaction)	Kedaluwarsa. Mendaftarkan dalam transaksi yang ditentukan sebagai transaksi terdistribusi.
EnlistTransaction(Transaction)	Kedaluwarsa. Mendaftarkan dalam transaksi yang ditentukan sebagai transaksi terdistribusi.
Equals(Object)	Kedaluwarsa. Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Kedaluwarsa. Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetSchema()	Kedaluwarsa. Mengembalikan informasi skema untuk sumber data ini OracleConnection.
GetSchema(String)	Kedaluwarsa. Mengembalikan informasi skema untuk sumber data ini OracleConnection menggunakan string yang ditentukan untuk nama skema.
GetSchema(String, String[])	Kedaluwarsa. Mengembalikan informasi skema untuk sumber data ini OracleConnection menggunakan string yang ditentukan untuk nama skema dan array string yang ditentukan untuk nilai pembatasan.
GetSchemaAsync(CancellationToken)	Kedaluwarsa. Ini adalah versi asinkron dari GetSchema(). Penyedia harus mengambil alih dengan implementasi yang sesuai. Secara cancellationToken opsional dapat dihormati. Implementasi default memanggil panggilan sinkron GetSchema() dan mengembalikan tugas yang telah selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika lulus yang sudah dibatalkan cancellationToken. Pengecualian yang dilemparkan oleh GetSchema() akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan. (Diperoleh dari DbConnection)
GetSchemaAsync(String, CancellationToken)	Kedaluwarsa. Ini adalah versi asinkron dari GetSchema(String). Penyedia harus mengambil alih dengan implementasi yang sesuai. Secara cancellationToken opsional dapat dihormati. Implementasi default memanggil panggilan sinkron GetSchema(String) dan mengembalikan tugas yang telah selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika lulus yang sudah dibatalkan cancellationToken. Pengecualian yang dilemparkan oleh GetSchema(String) akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan. (Diperoleh dari DbConnection)
GetSchemaAsync(String, String[], CancellationToken)	Kedaluwarsa. Ini adalah versi asinkron dari GetSchema(String, String[]). Penyedia harus mengambil alih dengan implementasi yang sesuai. Secara cancellationToken opsional dapat dihormati. Implementasi default memanggil panggilan sinkron GetSchema(String, String[]) dan mengembalikan tugas yang telah selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika lulus yang sudah dibatalkan cancellationToken. Pengecualian yang dilemparkan oleh GetSchema(String, String[]) akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan. (Diperoleh dari DbConnection)
GetService(Type)	Kedaluwarsa. Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetType()	Kedaluwarsa. Mendapatkan instans Type saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Kedaluwarsa. Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Kedaluwarsa. Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Kedaluwarsa. Memunculkan kejadian StateChange. (Diperoleh dari DbConnection)
Open()	Kedaluwarsa. Membuka koneksi ke database dengan pengaturan properti yang ditentukan oleh ConnectionString.
OpenAsync()	Kedaluwarsa. Versi asinkron dari Open(), yang membuka koneksi database dengan pengaturan yang ditentukan oleh ConnectionString. Metode ini memanggil metode OpenAsync(CancellationToken) virtual dengan CancellationToken.None. (Diperoleh dari DbConnection)
OpenAsync(CancellationToken)	Kedaluwarsa. Ini adalah versi asinkron dari Open(). Penyedia harus mengambil alih dengan implementasi yang sesuai. Token pembatalan dapat secara opsional dihormati. Implementasi default memanggil panggilan sinkron Open() dan mengembalikan tugas yang telah selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika melewati cancellationToken yang sudah dibatalkan. Pengecualian yang dilemparkan oleh Buka akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan. Jangan memanggil metode dan properti lain dari DbConnection objek sampai Tugas yang dikembalikan selesai. (Diperoleh dari DbConnection)
ToString()	Kedaluwarsa. Mengembalikan yang String berisi nama Component, jika ada. Metode ini tidak boleh ditimpa. (Diperoleh dari Component)

Acara

Disposed	Kedaluwarsa. Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode . (Diperoleh dari Component)
InfoMessage	Kedaluwarsa. Terjadi ketika Oracle mengirim peringatan atau pesan informasi.
StateChange	Kedaluwarsa. Terjadi ketika status koneksi berubah. (Diperoleh dari DbConnection)

Implementasi Antarmuka Eksplisit

ICloneable.Clone()	Kedaluwarsa. Membuat objek baru yang merupakan salinan instans saat ini.
IDbConnection.BeginTransaction()	Kedaluwarsa. Memulai transaksi database. (Diperoleh dari DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Kedaluwarsa. Memulai transaksi database dengan tingkat isolasi yang ditentukan. (Diperoleh dari DbConnection)
IDbConnection.CreateCommand()	Kedaluwarsa. Membuat dan mengembalikan DbCommand objek yang terkait dengan koneksi saat ini. (Diperoleh dari DbConnection)

Lihat juga

• OracleDataAdapter
• OracleCommand