OdbcConnection Kelas

Definisi

Ruang nama:

System.Data.Odbc

Rakitan:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v11.0.0-preview.2.26159.112

Sumber:

OdbcConnection.cs

Mewakili koneksi terbuka ke sumber data.

public ref class OdbcConnection sealed : System::Data::Common::DbConnection, ICloneable

public sealed class OdbcConnection : System.Data.Common.DbConnection, ICloneable

type OdbcConnection = class
    inherit DbConnection
    interface ICloneable

Public NotInheritable Class OdbcConnection
Inherits DbConnection
Implements ICloneable

Warisan

Object

DbConnection

OdbcConnection

Penerapan

ICloneable

Contoh

Contoh berikut membuat OdbcCommand dan OdbcConnection. OdbcConnection dibuka dan ditetapkan sebagai 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.

static private void InsertRow(string connectionString)
{
    string queryString =
        "INSERT INTO Customers (CustomerID, CompanyName) Values('NWIND', 'Northwind Traders')";
    OdbcCommand command = new OdbcCommand(queryString);

    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        command.Connection = connection;
        connection.Open();
        command.ExecuteNonQuery();

        // The connection is automatically closed at
        // the end of the Using block.
    }
}

Private Sub InsertRow(ByVal connectionString As String)

    Dim queryString As String = _
        "INSERT INTO Customers (CustomerID, CompanyName) Values('NWIND', 'Northwind Traders')"
    Dim command As New OdbcCommand(queryString)

    Using connection As New OdbcConnection(connectionString)
        command.Connection = connection
        connection.Open()
        command.ExecuteNonQuery()

        ' The connection is automatically closed at
        ' the end of the Using block.
    End Using
End Sub

Keterangan

Objek OdbcConnection mewakili koneksi unik ke sumber data yang dibuat dengan menggunakan string koneksi atau nama sumber data ODBC (DSN). Dengan sistem database klien/server, itu setara dengan koneksi jaringan ke server. Bergantung pada fungsionalitas yang didukung oleh driver ODBC asli, beberapa metode atau properti OdbcConnection objek mungkin tidak tersedia.

Objek menggunakan OdbcConnection sumber daya asli seperti lingkungan ODBC dan handel koneksi. Anda harus selalu secara eksplisit menutup objek yang terbuka OdbcConnection dengan memanggil Close atau Membuang sebelum OdbcConnection objek keluar dari cakupan, atau dengan menempatkan koneksi dalam Using pernyataan. Tidak melakukan ini meninggalkan membebaskan sumber daya asli ini untuk pengumpulan sampah. Ini mungkin tidak segera membebaskan mereka. Ini, pada gilirannya, akhirnya dapat menyebabkan driver yang mendasarinya kehabisan sumber daya atau mencapai batas maksimum. Ini telah mengakibatkan kegagalan terputus-terputus. Misalnya, Anda mungkin mengalami Maximum Connections kesalahan -related saat banyak koneksi menunggu untuk dihapus oleh pengumpul sampah. Menutup koneksi secara eksplisit memungkinkan penggunaan sumber daya asli yang lebih efisien, meningkatkan skalabilitas, dan meningkatkan performa aplikasi secara keseluruhan.

Nota

Untuk menyebarkan aplikasi berkinerja tinggi, Anda sering harus menggunakan pengumpulan koneksi. Namun, ketika Anda menggunakan Penyedia Data .NET Framework untuk ODBC, Anda tidak perlu mengaktifkan pengumpulan koneksi karena penyedia mengelola ini secara otomatis.

Jika salah Execute satu metode OdbcCommand kelas menyebabkan fatal OdbcException (misalnya, tingkat keparahan SQL Server 20 atau lebih besar), OdbcConnection mungkin akan ditutup. Namun, pengguna dapat membuka kembali koneksi dan melanjutkan.

Aplikasi yang membuat instans OdbcConnection objek dapat mengharuskan semua penelepon langsung dan tidak langsung untuk memiliki izin yang memadai ke kode dengan mengatur tuntutan keamanan deklaratif atau imperatif. OdbcConnection membuat tuntutan keamanan dengan menggunakan OdbcPermission objek . Pengguna dapat memverifikasi bahwa kode mereka memiliki izin yang memadai dengan menggunakan OdbcPermissionAttribute objek . Pengguna dan administrator juga dapat menggunakan Alat Kebijakan Keamanan Akses Kode (Caspol.exe) 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 sumber data, lihat Peristiwa Koneksi.

Konstruktor

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

Properti

Nama	Deskripsi
ConnectionString	Mendapatkan atau mengatur string yang digunakan untuk membuka sumber data.
ConnectionTimeout	Mendapatkan atau mengatur 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.
Driver	Mendapatkan nama driver ODBC yang ditentukan untuk koneksi saat ini.
ServerVersion	Mendapatkan string yang berisi versi server tempat klien tersambung.
State	Mendapatkan status koneksi saat ini.

Metode

Nama	Deskripsi
BeginTransaction()	Memulai transaksi di sumber data.
BeginTransaction(IsolationLevel)	Memulai transaksi di sumber data dengan nilai yang ditentukan IsolationLevel .
ChangeDatabase(String)	Mengubah database saat ini yang terkait dengan terbuka OdbcConnection.
Close()	Menutup koneksi ke sumber data.
CreateCommand()	Membuat dan mengembalikan objek yang OdbcCommand terkait dengan OdbcConnection.
GetSchema()	Mengembalikan informasi skema untuk sumber data ini OdbcConnection.
GetSchema(String, String[])	Mengembalikan informasi skema untuk sumber data ini OdbcConnection menggunakan string yang ditentukan untuk nama skema dan array string yang ditentukan untuk nilai pembatasan.
GetSchema(String)	Mengembalikan informasi skema untuk sumber data ini OdbcConnection menggunakan nama yang ditentukan untuk nama skema.
Open()	Membuka koneksi ke sumber data dengan pengaturan properti yang ditentukan oleh ConnectionString.
ReleaseObjectPool()	Menunjukkan bahwa handel lingkungan Odbc Driver Manager dapat dirilis ketika koneksi terakhir yang mendasarinya dirilis.

Acara

Nama	Deskripsi
InfoMessage	Terjadi ketika driver ODBC mengirim peringatan atau pesan informasi.

Implementasi Antarmuka Eksplisit

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

Lihat juga

• Menyambungkan ke Sumber Data