DbConnection Kelas

Definisi

Ruang nama:

System.Data.Common

Rakitan:

System.Data.Common.dll

Sumber:

DbConnection.cs

Menentukan perilaku inti Penghubungan Database dan menyediakan kelas dasar untuk koneksi khusus database.

public ref class DbConnection abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbConnection

public abstract class DbConnection : System.ComponentModel.Component, IAsyncDisposable, IDisposable, System.Data.IDbConnection

type DbConnection = class
    inherit Component
    interface IDbConnection
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbConnection
Inherits Component
Implements IAsyncDisposable, IDbConnection, IDisposable

Warisan

Object

MarshalByRefObject

Component

DbConnection

Turunan

System.Data.EntityClient.EntityConnection

System.Data.Odbc.OdbcConnection

System.Data.OleDb.OleDbConnection

System.Data.SqlClient.SqlConnection

Penerapan

IDisposable IDbConnection IAsyncDisposable

Catatan Bagi Implementer

Ketika Anda mewarisi dari DbConnection, Anda harus mengambil alih anggota berikut: Close(), , BeginDbTransaction(IsolationLevel), ChangeDatabase(String)CreateDbCommand(), Open(), dan StateChange. Anda juga harus menyediakan properti berikut: ConnectionString, , Database, DataSourceServerVersion, dan State.

Konstruktor

DbConnection()

Menginisialisasi instans baru kelas DbConnection.

Properti

CanCreateBatch	Mendapatkan nilai yang menunjukkan apakah instans DbBatch ini DbConnection mendukung kelas .
CanRaiseEvents	Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
ConnectionString	Saat ditimpa di kelas turunan, mendapatkan atau mengatur string yang digunakan untuk membuka koneksi.
ConnectionTimeout	Mendapatkan waktu untuk menunggu (dalam detik) saat membuat koneksi sebelum mengakhiri upaya dan menghasilkan kesalahan.
Container	IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component)
Database	Saat ditimpa di kelas turunan, mendapatkan nama database saat ini setelah koneksi dibuka, atau nama database yang ditentukan dalam string koneksi sebelum koneksi dibuka.
DataSource	Saat ditimpa di kelas turunan, mendapatkan nama server database yang akan disambungkan.
DbProviderFactory	DbProviderFactory Mendapatkan untuk iniDbConnection.
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)
ServerVersion	Ketika ditimpa di kelas turunan, mendapatkan string yang mewakili versi server tempat objek tersambung.
Site	Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component)
State	Mendapatkan string yang menjelaskan status koneksi.

Metode

BeginDbTransaction(IsolationLevel)	Saat ditimpa di kelas turunan, memulai transaksi database.
BeginDbTransactionAsync(IsolationLevel, CancellationToken)	Secara asinkron memulai transaksi database.
BeginTransaction()	Memulai transaksi database.
BeginTransaction(IsolationLevel)	Memulai transaksi database dengan tingkat isolasi yang ditentukan.
BeginTransactionAsync(CancellationToken)	Secara asinkron memulai transaksi database.
BeginTransactionAsync(IsolationLevel, CancellationToken)	Secara asinkron memulai transaksi database.
ChangeDatabase(String)	Saat ditimpa di kelas turunan, ubah database saat ini untuk koneksi terbuka.
ChangeDatabaseAsync(String, CancellationToken)	Secara asinkron mengubah database saat ini untuk koneksi terbuka.
Close()	Saat ditimpa di kelas turunan, menutup koneksi ke database.
CloseAsync()	Secara asinkron menutup koneksi ke database.
CreateBatch()	Mengembalikan instans baru kelas penyedia yang mengimplementasikan DbBatch kelas .
CreateCommand()	Membuat dan mengembalikan objek yang DbCommand terkait dengan koneksi saat ini.
CreateDbBatch()	Saat ditimpa di kelas turunan, mengembalikan instans baru kelas penyedia yang mengimplementasikan DbBatch kelas .
CreateDbCommand()	Saat ditimpa di kelas turunan, membuat dan mengembalikan objek yang DbCommand terkait dengan koneksi saat ini.
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()	Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh Component dan secara opsional merilis sumber daya terkelola. (Diperoleh dari Component)
DisposeAsync()	Secara asinkron membuang objek koneksi.
EnlistTransaction(Transaction)	Daftarkan dalam transaksi yang ditentukan.
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 DbConnection.
GetSchema(String)	Mengembalikan informasi skema untuk sumber data ini DbConnection menggunakan string yang ditentukan untuk nama skema.
GetSchema(String, String[])	Mengembalikan informasi skema untuk sumber data ini DbConnection 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 secara opsional dapat dihormati. Implementasi default memanggil panggilan sinkron GetSchema() dan mengembalikan tugas yang selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika lulus yang sudah dibatalkan cancellationToken. Pengecualian yang dilemparkan GetSchema() akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan.
GetSchemaAsync(String, CancellationToken)	Ini adalah versi asinkron dari GetSchema(String). Penyedia harus mengambil alih dengan implementasi yang sesuai. cancellationToken secara opsional dapat dihormati. Implementasi default memanggil panggilan sinkron GetSchema(String) dan mengembalikan tugas yang selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika lulus yang sudah dibatalkan cancellationToken. Pengecualian yang dilemparkan GetSchema(String) akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan.
GetSchemaAsync(String, String[], CancellationToken)	Ini adalah versi asinkron dari GetSchema(String, String[]). Penyedia harus mengambil alih dengan implementasi yang sesuai. cancellationToken secara opsional dapat dihormati. Implementasi default memanggil panggilan sinkron GetSchema(String, String[]) dan mengembalikan tugas yang selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika lulus yang sudah dibatalkan cancellationToken. Pengecualian yang dilemparkan GetSchema(String, String[]) akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan.
GetService(Type)	Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetType()	Mendapatkan dari 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.
Open()	Saat ditimpa di kelas turunan, membuka koneksi database dengan pengaturan 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.
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 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 DbConnection objek lain sampai Tugas yang dikembalikan selesai.
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)
StateChange	Terjadi ketika status koneksi berubah.

Implementasi Antarmuka Eksplisit

IDbConnection.BeginTransaction()	Memulai transaksi database.
IDbConnection.BeginTransaction(IsolationLevel)	Memulai transaksi database dengan tingkat isolasi yang ditentukan.
IDbConnection.CreateCommand()	Membuat dan mengembalikan DbCommand objek yang terkait dengan koneksi saat ini.

Metode Ekstensi

ConfigureAwait(IAsyncDisposable, Boolean)

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

Lihat juga

• DbProviderFactories (ADO.NET)
• Ringkasan ADO.NET