OleDbCommand 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 pernyataan SQL atau prosedur tersimpan untuk dijalankan terhadap sumber data.
public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable
public ref class OleDbCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable
public sealed class OleDbCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable
type OleDbCommand = class
inherit DbCommand
interface ICloneable
interface IDbCommand
interface IDisposable
type OleDbCommand = class
inherit Component
interface ICloneable
interface IDbCommand
interface IDisposable
type OleDbCommand = class
inherit DbCommand
interface IDbCommand
interface IDisposable
interface ICloneable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable
- Warisan
- Warisan
- Penerapan
Contoh
Contoh berikut menggunakan OleDbCommand, bersama OleDbDataAdapter dan OleDbConnection, untuk memilih baris dari database Access. Yang diisi DataSet kemudian dikembalikan. Contohnya diteruskan sebagai inisialisasi DataSet, string koneksi, string kueri yang merupakan pernyataan SQL SELECT, dan string yang merupakan nama tabel database sumber.
public void ReadMyData(string connectionString)
{
string queryString = "SELECT OrderID, CustomerID FROM Orders";
using (OleDbConnection connection = new OleDbConnection(connectionString))
{
OleDbCommand command = new OleDbCommand(queryString, connection);
connection.Open();
OleDbDataReader reader = command.ExecuteReader();
while (reader.Read())
{
Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1));
}
// always call Close when done reading.
reader.Close();
}
}
Public Sub ReadMyData(ByVal connectionString As String)
Dim queryString As String = "SELECT OrderID, CustomerID FROM Orders"
Using connection As New OleDbConnection(connectionString)
Dim command As New OleDbCommand(queryString, connection)
connection.Open()
Dim reader As OleDbDataReader = command.ExecuteReader()
While reader.Read()
Console.WriteLine(reader.GetInt32(0).ToString() + ", " _
+ reader.GetString(1))
End While
' always call Close when done reading.
reader.Close()
End Using
End Sub
Keterangan
Saat instans OleDbCommand dibuat, properti baca/tulis diatur ke nilai awalnya. Untuk daftar nilai-nilai ini, lihat OleDbCommand konstruktor.
OleDbCommand fitur metode berikut menjalankan perintah di sumber data:
Item | Deskripsi |
---|---|
ExecuteReader | Menjalankan perintah yang mengembalikan baris. ExecuteReader mungkin tidak memiliki efek yang Anda inginkan jika digunakan untuk menjalankan perintah seperti pernyataan SQL SET. |
ExecuteNonQuery | Menjalankan perintah seperti pernyataan SQL INSERT, DELETE, UPDATE, dan SET. |
ExecuteScalar | Mengambil nilai tunggal, misalnya, nilai agregat dari database. |
Anda dapat mengatur ulang CommandText properti dan menggunakan OleDbCommand kembali objek . Namun, Anda harus menutup OleDbDataReader sebelum dapat menjalankan perintah baru atau sebelumnya.
Jika fatal OleDbException (misalnya, tingkat keparahan SQL Server 20 atau lebih besar) dihasilkan oleh metode yang mengeksekusi OleDbCommand, OleDbConnection, koneksi mungkin ditutup. Namun, pengguna dapat membuka kembali koneksi dan melanjutkan.
Konstruktor
OleDbCommand() |
Menginisialisasi instans baru kelas OleDbCommand. |
OleDbCommand(String) |
Menginisialisasi instans OleDbCommand baru kelas dengan teks kueri. |
OleDbCommand(String, OleDbConnection) |
Menginisialisasi instans OleDbCommand baru kelas dengan teks kueri dan OleDbConnection. |
OleDbCommand(String, OleDbConnection, OleDbTransaction) |
Menginisialisasi instans OleDbCommand baru kelas dengan teks kueri, OleDbConnection, dan Transaction. |
Properti
CanRaiseEvents |
Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component) |
CommandText |
Mendapatkan atau mengatur pernyataan SQL atau prosedur tersimpan untuk dijalankan di sumber data. |
CommandTimeout |
Mendapatkan atau mengatur waktu tunggu (dalam detik) sebelum mengakhiri upaya untuk menjalankan perintah dan menghasilkan kesalahan. |
CommandType |
Mendapatkan atau menetapkan nilai yang menunjukkan bagaimana properti ditafsirkan CommandText . |
Connection |
Mendapatkan atau mengatur yang OleDbConnection digunakan oleh instans ini dari OleDbCommand. |
Container |
IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component) |
DbConnection |
Mendapatkan atau mengatur yang DbConnection digunakan oleh ini DbCommand. (Diperoleh dari DbCommand) |
DbParameterCollection |
Mendapatkan koleksi DbParameter objek. (Diperoleh dari DbCommand) |
DbTransaction |
Mendapatkan atau mengatur tempat DbTransaction objek ini DbCommand dijalankan. (Diperoleh dari DbCommand) |
DesignMode |
Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component) |
DesignTimeVisible |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah objek perintah harus terlihat dalam kontrol Formulir Windows Designer yang disesuaikan. |
Events |
Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component) |
Parameters |
OleDbParameterCollectionMendapatkan . |
Site |
Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component) |
Transaction |
Mendapatkan atau mengatur tempat OleDbTransactionOleDbCommand eksekusi. |
UpdatedRowSource |
Mendapatkan atau mengatur bagaimana hasil perintah diterapkan ke DataRow saat digunakan oleh |
Metode
Cancel() |
Mencoba membatalkan eksekusi OleDbCommand. |
Clone() |
Membuat objek baru OleDbCommand yang merupakan salinan instans saat ini. |
CreateDbParameter() |
Membuat instans DbParameter baru objek. (Diperoleh dari DbCommand) |
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) |
CreateParameter() |
Membuat instans OleDbParameter baru objek. |
Dispose() |
Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, melepaskan, atau mereset sumber daya yang tidak terkelola. (Diperoleh dari DbCommand) |
Dispose() |
Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component) |
Dispose(Boolean) |
Merilis sumber daya tidak terkelola yang DbCommand digunakan oleh dan secara opsional merilis sumber daya terkelola. (Diperoleh dari DbCommand) |
Dispose(Boolean) |
Merilis sumber daya tidak terkelola yang Component digunakan oleh dan secara opsional merilis sumber daya terkelola. (Diperoleh dari Component) |
DisposeAsync() |
Secara asinkron membuang objek perintah. (Diperoleh dari DbCommand) |
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
ExecuteDbDataReader(CommandBehavior) |
Menjalankan perintah terhadap koneksinya, mengembalikan yang DbDataReader dapat digunakan untuk mengakses hasilnya. (Diperoleh dari DbCommand) |
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) |
Penyedia harus menerapkan metode ini untuk menyediakan implementasi non-default untuk ExecuteReader kelebihan beban. Implementasi default memanggil metode sinkron ExecuteReader() dan mengembalikan tugas yang selesai, memblokir utas panggilan. Implementasi default akan mengembalikan tugas yang dibatalkan jika melewati token pembatalan yang sudah dibatalkan. Pengecualian yang dilemparkan oleh ExecuteReader akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan. Metode ini menerima token pembatalan yang dapat digunakan untuk meminta operasi dibatalkan lebih awal. Implementasi dapat mengabaikan permintaan ini. (Diperoleh dari DbCommand) |
ExecuteNonQuery() |
Menjalankan pernyataan SQL terhadap Connection dan mengembalikan jumlah baris yang terpengaruh. |
ExecuteNonQueryAsync() |
Versi asinkron dari ExecuteNonQuery(), yang menjalankan perintah terhadap objek koneksinya, mengembalikan jumlah baris yang terpengaruh. ExecuteNonQueryAsync(CancellationToken) Memanggil dengan CancellationToken.None. (Diperoleh dari DbCommand) |
ExecuteNonQueryAsync(CancellationToken) |
Ini adalah versi asinkron dari ExecuteNonQuery(). Penyedia harus mengambil alih dengan implementasi yang sesuai. Token pembatalan dapat diabaikan secara opsional. Implementasi default memanggil metode sinkron ExecuteNonQuery() dan mengembalikan tugas yang selesai, memblokir utas panggilan. Implementasi default akan mengembalikan tugas yang dibatalkan jika melewati token pembatalan yang sudah dibatalkan. Pengecualian yang dilemparkan oleh ExecuteNonQuery() akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan. Jangan memanggil metode dan properti lain dari |
ExecuteReader() |
CommandText Mengirim ke Connection dan membangun OleDbDataReader. |
ExecuteReader(CommandBehavior) |
CommandText Mengirim ke Connection, dan membangun OleDbDataReader menggunakan salah CommandBehavior satu nilai. |
ExecuteReaderAsync() |
Versi asinkron dari ExecuteReader, yang menjalankan perintah terhadap koneksinya, mengembalikan DbDataReader yang dapat digunakan untuk mengakses hasilnya. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Memanggil dengan CancellationToken.None. (Diperoleh dari DbCommand) |
ExecuteReaderAsync(CancellationToken) |
Versi asinkron dari ExecuteReader, yang menjalankan perintah terhadap koneksinya, mengembalikan DbDataReader yang dapat digunakan untuk mengakses hasilnya. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Memanggil . (Diperoleh dari DbCommand) |
ExecuteReaderAsync(CommandBehavior) |
Versi asinkron dari ExecuteReader, yang menjalankan perintah terhadap koneksinya, mengembalikan DbDataReader yang dapat digunakan untuk mengakses hasilnya. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Memanggil . (Diperoleh dari DbCommand) |
ExecuteReaderAsync(CommandBehavior, CancellationToken) |
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Memanggil . (Diperoleh dari DbCommand) |
ExecuteScalar() |
Menjalankan kueri, dan mengembalikan kolom pertama dari baris pertama dalam tataan hasil yang dikembalikan oleh kueri. Kolom atau baris tambahan diabaikan. |
ExecuteScalarAsync() |
Versi asinkron dari ExecuteScalar(), yang menjalankan perintah dan mengembalikan kolom pertama dari baris pertama dalam tataan hasil pertama yang dikembalikan. Semua kolom, baris, dan tataan hasil lainnya diabaikan. ExecuteScalarAsync(CancellationToken) Memanggil dengan CancellationToken.None. (Diperoleh dari DbCommand) |
ExecuteScalarAsync(CancellationToken) |
Ini adalah versi asinkron dari ExecuteScalar(). Penyedia harus mengambil alih dengan implementasi yang sesuai. Token pembatalan dapat diabaikan secara opsional. Implementasi default memanggil metode sinkron ExecuteScalar() dan mengembalikan tugas yang selesai, memblokir utas panggilan. Implementasi default akan mengembalikan tugas yang dibatalkan jika melewati token pembatalan yang sudah dibatalkan. Pengecualian yang dilemparkan oleh ExecuteScalar akan dikomunikasikan melalui properti Pengecualian Tugas yang dikembalikan. Jangan memanggil metode dan properti lain dari |
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) |
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 yang saat ini Object. (Diperoleh dari Object) |
MemberwiseClone(Boolean) |
Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject) |
Prepare() |
Membuat versi perintah yang disiapkan (atau dikompilasi) pada sumber data. |
PrepareAsync(CancellationToken) |
Secara asinkron membuat versi perintah yang disiapkan (atau dikompilasi) pada sumber data. (Diperoleh dari DbCommand) |
ResetCommandTimeout() |
Mereset CommandTimeout properti ke nilai default. |
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) |
Implementasi Antarmuka Eksplisit
ICloneable.Clone() |
Untuk deskripsi anggota ini, lihat Clone(). |
IDbCommand.Connection |
Mendapatkan atau mengatur yang IDbConnection digunakan oleh instans ini dari IDbCommand. (Diperoleh dari DbCommand) |
IDbCommand.CreateParameter() |
API ini mendukung infrastruktur produk dan tidak dimaksudkan untuk digunakan langsung dari kode Anda. Membuat instans IDbDataParameter baru objek. |
IDbCommand.CreateParameter() |
Membuat instans IDbDataParameter baru objek. (Diperoleh dari DbCommand) |
IDbCommand.ExecuteReader() |
Untuk deskripsi anggota ini, lihat ExecuteReader(). |
IDbCommand.ExecuteReader(CommandBehavior) |
CommandText Menjalankan terhadap Connection, dan membangun IDataReader menggunakan salah CommandBehavior satu nilai. |
IDbCommand.Parameters |
IDataParameterCollectionMendapatkan . (Diperoleh dari DbCommand) |
IDbCommand.Transaction |
Mendapatkan atau mengatur tempat DbTransaction objek ini DbCommand dijalankan. (Diperoleh dari DbCommand) |
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