OleDbConnection Kelas

Definisi

Ruang nama:

System.Data.OleDb

Rakitan:

System.Data.OleDb.dll

Paket:

System.Data.OleDb v11.0.0-preview.4.26230.115

Sumber:

OleDbConnection.cs

Mewakili koneksi terbuka ke sumber data.

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

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbConnection : System.Data.Common.DbConnection, ICloneable, IDisposable

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbConnection = class
    inherit DbConnection
    interface IDbConnection
    interface IDisposable
    interface ICloneable

Public NotInheritable Class OleDbConnection
Inherits DbConnection
Implements ICloneable, IDisposable

Warisan

Object

DbConnection

OleDbConnection

Atribut

RequiresDynamicCodeAttribute

Penerapan

IDbConnection ICloneable IDisposable

Contoh

Contoh berikut membuat OleDbCommand dan OleDbConnection. OleDbConnection dibuka dan ditetapkan sebagai Connection untuk OleDbCommand. 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 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.

Jika keluar OleDbConnection 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.

Note

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

Jika OleDbException fatal (misalnya, tingkat keparahan SQL Server 20 atau lebih besar) dihasilkan oleh metode yang menjalankan 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 untuk 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 (Code Access Security Policy Tool) untuk memodifikasi kebijakan keamanan di tingkat komputer, pengguna, dan perusahaan. Untuk informasi selengkapnya, lihat Keamanan Akses Kode dan ADO.NET.

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

Note

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

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

Properti

Nama	Deskripsi
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.
Database	Mendapatkan nama database saat ini atau database yang akan digunakan setelah koneksi dibuka.
DataSource	Mendapatkan nama server atau nama file sumber data.
Provider	Mendapatkan nama penyedia OLE DB yang ditentukan dalam klausa "Provider= " dari string koneksi.
ServerVersion	Mendapatkan string yang berisi versi server tempat klien tersambung.
State	Mendapatkan status koneksi saat ini.

Metode

Nama	Deskripsi
BeginTransaction()	Memulai transaksi database dengan nilai saat ini IsolationLevel .
BeginTransaction(IsolationLevel)	Memulai transaksi database dengan tingkat isolasi yang ditentukan.
ChangeDatabase(String)	Mengubah database saat ini untuk membuka OleDbConnection.
Close()	Menutup koneksi ke sumber data.
CreateCommand()	Membuat dan mengembalikan objek yang OleDbCommand terkait dengan OleDbConnection.
EnlistTransaction(Transaction)	Mendaftarkan dalam transaksi yang ditentukan sebagai transaksi terdistribusi.
GetOleDbSchemaTable(Guid, Object[])	Mengembalikan informasi skema dari sumber data seperti yang ditunjukkan oleh GUID, dan setelah menerapkan pembatasan yang ditentukan.
GetSchema()	Mengembalikan informasi skema untuk sumber data ini OleDbConnection.
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.
GetSchema(String)	Mengembalikan informasi skema untuk sumber data ini OleDbConnection menggunakan string yang ditentukan untuk nama skema.
Open()	Membuka koneksi database dengan pengaturan properti yang ditentukan oleh ConnectionString.
ReleaseObjectPool()	Menunjukkan bahwa kumpulan OleDbConnection objek dapat dirilis ketika koneksi terakhir yang mendasar dirilis.
ResetState()	State Memperbarui properti OleDbConnection objek.

Acara

Nama	Deskripsi
InfoMessage	Terjadi ketika penyedia mengirim peringatan atau pesan informasi.

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
ICloneable.Clone()	Untuk deskripsi anggota ini, lihat Clone().

Lihat juga

• Menyambungkan ke Sumber Data