OleDbConnection Kelas

Definisi

Ruang nama:

System.Data.OleDb

Rakitan:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v9.0.0-preview.3.24172.9

Sumber:

OleDbConnection.cs

Mewakili koneksi terbuka ke sumber data.

public ref class OleDbConnection sealed : System::Data::Common::DbConnection, ICloneable, IDisposable

public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable, IDisposable

type OleDbConnection = class
    inherit DbConnection
    interface ICloneable
    interface IDbConnection
    interface IDisposable

Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDisposable

Warisan

Object

MarshalByRefObject

Component

DbConnection

OleDbConnection

Penerapan

IDbConnection ICloneable IDisposable

Contoh

Contoh berikut membuat OleDbCommand dan OleDbConnection. OleDbConnection dibuka dan ditetapkan sebagai Connection untuk OleDbCommand. Contohnya 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 insertSQL)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        // The insertSQL string contains a SQL statement that
        // inserts a new row in the source table.
        OleDbCommand command = new OleDbCommand(insertSQL);

        // Set the Connection to the new OleDbConnection.
        command.Connection = connection;

        // Open the connection and execute the insert command.
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
}

Public Sub InsertRow(ByVal connectionString As String, _
    ByVal insertSQL As String)

    Using connection As New OleDbConnection(connectionString)
        ' The insertSQL string contains a SQL statement that
        ' inserts a new row in the source table.
        Dim command As New OleDbCommand(insertSQL)

        ' Set the Connection to the new OleDbConnection.
        command.Connection = connection

        ' Open the connection and execute the insert command.
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

Keterangan

Objek OleDbConnection mewakili koneksi unik ke sumber data. Dengan sistem database klien/server, itu setara dengan koneksi jaringan ke server. Bergantung pada fungsionalitas yang didukung oleh penyedia OLE DB asli, beberapa metode atau properti OleDbConnection objek mungkin tidak tersedia.

Saat Anda membuat instans OleDbConnection, semua properti diatur ke nilai awalnya. Untuk daftar nilai-nilai ini, lihat OleDbConnection konstruktor.

Anda dapat membuka lebih dari satu DataReader pada satu OleDbConnection. Jika penyedia OLE DB yang Anda gunakan tidak mendukung lebih dari satu DataReader pada satu koneksi, penyedia secara implisit membuka koneksi tambahan untuk masing-masing.

OleDbConnection Jika keluar dari cakupan, itu tidak ditutup. Oleh karena itu, Anda harus secara eksplisit menutup koneksi dengan memanggil Close atau Membuang, atau dengan menggunakan OleDbConnection objek dalam Using pernyataan.

Catatan

Untuk menyebarkan aplikasi berkinerja tinggi, Anda harus menggunakan pengumpulan koneksi. Saat Anda menggunakan Penyedia Data .NET Framework untuk OLE DB, Anda tidak perlu mengaktifkan pengumpulan koneksi karena penyedia mengelola ini secara otomatis. Untuk informasi selengkapnya tentang cara menggunakan pengumpulan koneksi dengan Penyedia Data .NET Framework untuk OLE DB, lihat Pengumpulan Koneksi OLE DB, ODBC, dan Oracle.

Jika fatal OleDbException (misalnya, tingkat keparahan SQL Server 20 atau lebih besar) dihasilkan oleh metode yang mengeksekusi OleDbCommand, OleDbConnection mungkin ditutup. Namun, pengguna dapat membuka kembali koneksi dan melanjutkan.

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

Untuk informasi selengkapnya tentang menangani pesan peringatan dan informasi dari server data, lihat Peristiwa Koneksi.

Catatan

Objek OleDbConnection tidak mendukung pengaturan atau pengambilan properti dinamis khusus untuk penyedia OLE DB. Hanya properti yang dapat diteruskan dalam string koneksi untuk penyedia OLE DB yang didukung.

Konstruktor

OleDbConnection()	Menginisialisasi instans baru kelas OleDbConnection.
OleDbConnection(String)	Menginisialisasi instans OleDbConnection baru kelas dengan string koneksi yang ditentukan.

Properti

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

Metode

BeginDbTransaction(IsolationLevel)	Saat ditimpa di kelas turunan, memulai transaksi database. (Diperoleh dari DbConnection)
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Secara asinkron memulai transaksi database. (Diperoleh dari DbConnection)
BeginTransaction()	Memulai transaksi database dengan nilai saat ini IsolationLevel .
BeginTransaction(IsolationLevel)	Memulai transaksi database dengan tingkat isolasi yang ditentukan.
BeginTransactionAsync(CancellationToken)	Secara asinkron memulai transaksi database. (Diperoleh dari DbConnection)
BeginTransactionAsync(IsolationLevel, CancellationToken)	Secara asinkron memulai transaksi database. (Diperoleh dari DbConnection)
ChangeDatabase(String)	Mengubah database saat ini untuk membuka OleDbConnection.
ChangeDatabaseAsync(String, CancellationToken)	Secara asinkron mengubah database saat ini untuk koneksi terbuka. (Diperoleh dari DbConnection)
Close()	Menutup koneksi ke sumber data.
CloseAsync()	Secara asinkron menutup koneksi ke database. (Diperoleh dari DbConnection)
CreateBatch()	Mengembalikan instans baru kelas penyedia yang mengimplementasikan DbBatch kelas . (Diperoleh dari DbConnection)
CreateCommand()	Membuat dan mengembalikan objek yang OleDbCommand terkait dengan OleDbConnection.
CreateDbBatch()	Saat ditimpa di kelas turunan, mengembalikan instans baru kelas penyedia yang mengimplementasikan DbBatch kelas . (Diperoleh dari DbConnection)
CreateDbCommand()	Saat ditimpa di kelas turunan, membuat dan mengembalikan objek yang DbCommand terkait dengan koneksi saat ini. (Diperoleh dari DbConnection)
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, melepaskan, atau mereset sumber daya yang tidak terkelola. (Diperoleh dari DbConnection)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang DbConnection digunakan oleh dan secara opsional merilis sumber daya terkelola. (Diperoleh dari DbConnection)
DisposeAsync()	Membuang objek koneksi secara asinkron. (Diperoleh dari DbConnection)
EnlistTransaction(Transaction)	Mendaftarkan dalam transaksi yang ditentukan sebagai transaksi terdistribusi.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Kedaluwarsa. Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetOleDbSchemaTable(Guid, Object[])	Mengembalikan informasi skema dari sumber data seperti yang ditunjukkan oleh GUID, dan setelah menerapkan batasan yang ditentukan.
GetSchema()	Mengembalikan informasi skema untuk sumber data ini OleDbConnection.
GetSchema(String)	Mengembalikan informasi skema untuk sumber data ini OleDbConnection menggunakan string yang ditentukan untuk nama skema.
GetSchema(String, String[])	Mengembalikan informasi skema untuk sumber data ini OleDbConnection menggunakan string yang ditentukan untuk nama skema dan array string yang ditentukan untuk nilai pembatasan.
GetSchemaAsync(CancellationToken)	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)	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)	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)	Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Memunculkan kejadian StateChange. (Diperoleh dari DbConnection)
Open()	Membuka koneksi database dengan pengaturan properti yang ditentukan oleh ConnectionString.
OpenAsync()	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)	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)
ReleaseObjectPool()	Menunjukkan bahwa kumpulan OleDbConnection objek dapat dirilis ketika koneksi yang mendasar terakhir dirilis.
ResetState()	State Updates properti OleDbConnection objek .
ToString()	Mengembalikan yang String berisi nama Component, jika ada. Metode ini tidak boleh ditimpa. (Diperoleh dari Component)

Acara

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

Implementasi Antarmuka Eksplisit

ICloneable.Clone()	Untuk deskripsi anggota ini, lihat Clone().
IDbConnection.BeginTransaction()	Memulai transaksi database. (Diperoleh dari DbConnection)
IDbConnection.BeginTransaction(IsolationLevel)	Memulai transaksi database dengan tingkat isolasi yang ditentukan. (Diperoleh dari DbConnection)
IDbConnection.CreateCommand()	Membuat dan mengembalikan DbCommand objek yang terkait dengan koneksi saat ini. (Diperoleh dari DbConnection)

Metode Ekstensi

ConfigureAwait(IAsyncDisposable, Boolean)

Mengonfigurasi bagaimana menunggu tugas yang dikembalikan dari asinkron sekali pakai dilakukan.

Lihat juga

• Menyambungkan ke Sumber Data