OdbcConnection Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mewakili koneksi terbuka ke sumber data.
public ref class OdbcConnection sealed : System::Data::Common::DbConnection, ICloneable
public ref class OdbcConnection sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbConnection
public sealed class OdbcConnection : System.Data.Common.DbConnection, ICloneable
public sealed class OdbcConnection : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbConnection
type OdbcConnection = class
inherit DbConnection
interface ICloneable
type OdbcConnection = class
inherit Component
interface ICloneable
interface IDbConnection
interface IDisposable
Public NotInheritable Class OdbcConnection
Inherits DbConnection
Implements ICloneable
Public NotInheritable Class OdbcConnection
Inherits Component
Implements ICloneable, IDbConnection, IDisposable
- Warisan
- Warisan
- Penerapan
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 nama sumber data (DSN) string koneksi atau ODBC. 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 OdbcConnection menggunakan 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. Mungkin tidak segera membebaskan mereka. Ini, pada gilirannya, pada akhirnya dapat menyebabkan driver yang mendasarinya kehabisan sumber daya atau mencapai batas maksimum. Hal ini mengakibatkan kegagalan terputus-terputus. Misalnya, Anda mungkin mengalami Maximum Connections
kesalahan terkait 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.
Catatan
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 ditutup. Namun, pengguna dapat membuka kembali koneksi dan melanjutkan.
Aplikasi yang membuat instans OdbcConnection objek dapat mengharuskan semua penelepon langsung dan tidak langsung memiliki izin yang memadai ke kode dengan mengatur permintaan 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 mengubah 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 sumber data, lihat Peristiwa Koneksi.
Konstruktor
OdbcConnection() |
Menginisialisasi instans baru kelas OdbcConnection. |
OdbcConnection(String) |
Menginisialisasi instans OdbcConnection 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 sumber data. |
ConnectionTimeout |
Mendapatkan atau mengatur 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) |
Driver |
Mendapatkan nama driver ODBC yang ditentukan untuk koneksi saat ini. |
Events |
Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component) |
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 di sumber data. |
BeginTransaction(IsolationLevel) |
Memulai transaksi di sumber data dengan nilai yang ditentukan IsolationLevel . |
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 pembukaan OdbcConnection. |
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 OdbcCommand terkait dengan OdbcConnection. |
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() |
Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component) |
Dispose(Boolean) |
Merilis sumber daya tidak terkelola yang DbConnection digunakan oleh dan secara opsional merilis sumber daya terkelola. (Diperoleh dari DbConnection) |
Dispose(Boolean) |
Merilis sumber daya tidak terkelola yang Component digunakan oleh dan secara opsional merilis sumber daya terkelola. (Diperoleh dari Component) |
DisposeAsync() |
Membuang objek koneksi secara asinkron. (Diperoleh dari DbConnection) |
EnlistDistributedTransaction(ITransaction) |
Mendaftarkan dalam transaksi yang ditentukan sebagai transaksi terdistribusi. |
EnlistTransaction(Transaction) |
Mendaftarkan dalam transaksi yang ditentukan sebagai transaksi terdistribusi. |
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 ini OdbcConnection. |
GetSchema(String) |
Mengembalikan informasi skema untuk sumber data ini OdbcConnection menggunakan nama yang ditentukan untuk nama skema. |
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. |
GetSchemaAsync(CancellationToken) |
Ini adalah versi asinkron dari GetSchema().
Penyedia harus mengambil alih dengan implementasi yang sesuai.
Secara |
GetSchemaAsync(String, CancellationToken) |
Ini adalah versi asinkron dari GetSchema(String).
Penyedia harus mengambil alih dengan implementasi yang sesuai.
Secara |
GetSchemaAsync(String, String[], CancellationToken) |
Ini adalah versi asinkron dari GetSchema(String, String[]).
Penyedia harus mengambil alih dengan implementasi yang sesuai.
Secara |
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 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 ke sumber data 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 |
ReleaseObjectPool() |
Menunjukkan bahwa handel lingkungan Odbc Driver Manager dapat dirilis ketika koneksi terakhir yang mendasar dirilis. |
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 driver ODBC mengirim peringatan atau pesan informasi. |
StateChange |
Terjadi ketika status koneksi berubah. |
StateChange |
Terjadi ketika status koneksi berubah. (Diperoleh dari DbConnection) |
Implementasi Antarmuka Eksplisit
ICloneable.Clone() |
Untuk deskripsi anggota ini, lihat Clone(). |
IDbConnection.BeginTransaction() |
API ini mendukung infrastruktur produk dan tidak dimaksudkan untuk digunakan langsung dari kode Anda. Memulai transaksi database. |
IDbConnection.BeginTransaction() |
Memulai transaksi database. (Diperoleh dari DbConnection) |
IDbConnection.BeginTransaction(IsolationLevel) |
API ini mendukung infrastruktur produk dan tidak dimaksudkan untuk digunakan langsung dari kode Anda. Memulai transaksi database dengan tingkat isolasi yang ditentukan. |
IDbConnection.BeginTransaction(IsolationLevel) |
Memulai transaksi database dengan tingkat isolasi yang ditentukan. (Diperoleh dari DbConnection) |
IDbConnection.CreateCommand() |
API ini mendukung infrastruktur produk dan tidak dimaksudkan untuk digunakan langsung dari kode Anda. Membuat dan mengembalikan objek perintah yang terkait dengan koneksi. |
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. |
Berlaku untuk
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk