OdbcConnection Kelas

Definisi

Ruang nama:

System.Data.Odbc

Rakitan:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v9.0.0-rc.1.24431.7

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

MarshalByRefObject

Component

DbConnection

OdbcConnection

Penerapan

ICloneable

Contoh

Contoh berikut membuat OdbcCommand dan OdbcConnection. OdbcConnection dibuka dan ditetapkan sebagai properti Connection. 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 objek OdbcConnection mungkin tidak tersedia.

Objek OdbcConnection menggunakan sumber daya asli seperti lingkungan ODBC dan handel koneksi. Anda harus selalu secara eksplisit menutup objek OdbcConnection terbuka dengan memanggil Close atau Membuang sebelum objek OdbcConnection keluar dari cakupan, atau dengan menempatkan koneksi dalam pernyataan Using. 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 kesalahan Maximum Connections -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 satu metode Execute kelas OdbcCommand menyebabkan OdbcException fatal (misalnya, tingkat keparahan SQL Server 20 atau lebih besar), OdbcConnection mungkin ditutup. Namun, pengguna dapat membuka kembali koneksi dan melanjutkan.

Aplikasi yang membuat instans objek OdbcConnection 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 objek OdbcPermission. Pengguna dapat memverifikasi bahwa kode mereka memiliki izin yang memadai dengan menggunakan objek OdbcPermissionAttribute. 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 pesan peringatan dan informasi dari sumber data, lihat Peristiwa Koneksi.

Konstruktor

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

Properti

CanCreateBatch	Mendapatkan nilai yang menunjukkan apakah instans DbConnection ini mendukung kelas DbBatch. (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 sumber data.
ConnectionTimeout	Mendapatkan atau mengatur waktu untuk menunggu (dalam detik) saat mencoba membuat koneksi sebelum mengakhiri upaya dan menghasilkan kesalahan.
Container	Mendapatkan IContainer 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	Mendapatkan DbProviderFactory untuk DbConnectionini. (Diperoleh dari DbConnection)
DesignMode	Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component)
Driver	Mendapatkan nama driver ODBC yang ditentukan untuk koneksi saat ini.
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke Componentini. (Diperoleh dari Component)
ServerVersion	Mendapatkan string yang berisi versi server tempat klien tersambung.
Site	Mendapatkan atau mengatur ISiteComponent. (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 di sumber data.
BeginTransaction(IsolationLevel)	Memulai transaksi di sumber data dengan nilai IsolationLevel 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 yang terkait dengan OdbcConnectionterbuka.
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 kelas DbBatch. (Diperoleh dari DbConnection)
CreateCommand()	Membuat dan mengembalikan objek OdbcCommand yang terkait dengan OdbcConnection.
CreateDbBatch()	Saat ditimpa di kelas turunan, mengembalikan instans baru kelas penyedia yang mengimplementasikan kelas DbBatch. (Diperoleh dari DbConnection)
CreateDbCommand()	Saat ditimpa di kelas turunan, membuat dan mengembalikan objek DbCommand yang 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, merilis, atau mengatur ulang sumber daya yang tidak dikelola. (Diperoleh dari DbConnection)
Dispose(Boolean)	Merilis sumber daya yang tidak dikelola yang digunakan oleh DbConnection dan secara opsional merilis sumber daya terkelola. (Diperoleh dari DbConnection)
DisposeAsync()	Secara asinkron membuang objek koneksi. (Diperoleh dari DbConnection)
EnlistTransaction(Transaction)	Daftar dalam transaksi yang ditentukan. (Diperoleh dari DbConnection)
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)
GetSchema()	Mengembalikan informasi skema untuk sumber data OdbcConnectionini.
GetSchema(String)	Mengembalikan informasi skema untuk sumber data OdbcConnection ini menggunakan nama yang ditentukan untuk nama skema.
GetSchema(String, String[])	Mengembalikan informasi skema untuk sumber data OdbcConnection ini 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. cancellationToken dapat secara opsional dihormati. Implementasi default memanggil panggilan GetSchema() sinkron dan mengembalikan tugas yang telah selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika melewati cancellationTokenyang sudah dibatalkan. 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. cancellationToken dapat secara opsional dihormati. Implementasi default memanggil panggilan GetSchema(String) sinkron dan mengembalikan tugas yang telah selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika melewati cancellationTokenyang sudah dibatalkan. 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. cancellationToken dapat secara opsional dihormati. Implementasi default memanggil panggilan GetSchema(String, String[]) sinkron dan mengembalikan tugas yang telah selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika melewati cancellationTokenyang sudah dibatalkan. 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 Type instans 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 Objectsaat ini. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek MarshalByRefObject saat ini. (Diperoleh dari MarshalByRefObject)
OnStateChange(StateChangeEventArgs)	Menaikkan peristiwa StateChange. (Diperoleh dari DbConnection)
Open()	Membuka koneksi ke sumber data dengan pengaturan properti yang ditentukan oleh ConnectionString.
OpenAsync()	Versi asinkron Open(), yang membuka koneksi database dengan pengaturan yang ditentukan oleh ConnectionString. Metode ini memanggil metode virtual OpenAsync(CancellationToken) 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 Open() sinkron 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 panggil metode dan properti lain dari objek DbConnection hingga Tugas yang dikembalikan selesai. (Diperoleh dari DbConnection)
ReleaseObjectPool()	Menunjukkan bahwa handel lingkungan Odbc Driver Manager dapat dirilis ketika koneksi terakhir yang mendasarinya dirilis.
ToString()	Mengembalikan String yang berisi nama Component, jika ada. Metode ini tidak boleh ditimpa. (Diperoleh dari Component)

Acara

Disposed	Terjadi ketika komponen dibuang oleh panggilan ke metode Dispose(). (Diperoleh dari Component)
InfoMessage	Terjadi ketika driver ODBC 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 objek DbCommand yang terkait dengan koneksi saat ini. (Diperoleh dari DbConnection)

Metode Ekstensi

ConfigureAwait(IAsyncDisposable, Boolean)

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

Lihat juga

• Menyambungkan ke sumber data