OleDbCommand Kelas

Definisi

Ruang nama:

System.Data.OleDb

Rakitan:

System.Data.OleDb.dll

Paket:

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

Sumber:

OleDbCommand.cs

Mewakili pernyataan SQL atau prosedur tersimpan untuk dijalankan terhadap sumber data.

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable

public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable

type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable

Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable

Warisan

Object

MarshalByRefObject

Component

DbCommand

OleDbCommand

Penerapan

IDbCommand ICloneable IDisposable

Contoh

Contoh berikut menggunakan OleDbCommand, di sepanjang OleDbDataAdapter dan OleDbConnection, untuk memilih baris dari database Access. DataSet yang diisi kemudian dikembalikan. Contohnya diteruskan DataSetyang diinisialisasi , 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 konstruktor OleDbCommand.

OleDbCommand fitur metode berikut yang menjalankan perintah di sumber data:

Benda	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 properti CommandText dan menggunakan kembali objek OleDbCommand. Namun, Anda harus menutup OleDbDataReader sebelum dapat menjalankan perintah baru atau sebelumnya.

Jika OleDbException fatal (misalnya, tingkat keparahan SQL Server 20 atau lebih besar) dihasilkan oleh metode yang menjalankan OleDbCommand, OleDbConnection, koneksi mungkin ditutup. Namun, pengguna dapat membuka kembali koneksi dan melanjutkan.

Konstruktor

OleDbCommand()	Menginisialisasi instans baru kelas OleDbCommand.
OleDbCommand(String)	Menginisialisasi instans baru kelas OleDbCommand dengan teks kueri.
OleDbCommand(String, OleDbConnection)	Menginisialisasi instans baru kelas OleDbCommand dengan teks kueri dan OleDbConnection.
OleDbCommand(String, OleDbConnection, OleDbTransaction)	Menginisialisasi instans baru kelas OleDbCommand 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 CommandText ditafsirkan.
Connection	Mendapatkan atau mengatur OleDbConnection yang digunakan oleh instans OleDbCommandini.
Container	Mendapatkan IContainer yang berisi Component. (Diperoleh dari Component)
DbConnection	Mendapatkan atau mengatur DbConnection yang digunakan oleh DbCommandini. (Diperoleh dari DbCommand)
DbParameterCollection	Mendapatkan koleksi objek DbParameter. (Diperoleh dari DbCommand)
DbTransaction	Mendapatkan atau mengatur DbTransaction tempat objek DbCommand ini 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 Windows Forms Designer yang dikustomisasi.
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke Componentini. (Diperoleh dari Component)
Parameters	Mendapatkan OleDbParameterCollection.
Site	Mendapatkan atau mengatur ISiteComponent. (Diperoleh dari Component)
Transaction	Mendapatkan atau mengatur OleDbTransaction tempat OleDbCommand dijalankan.
UpdatedRowSource	Mendapatkan atau mengatur bagaimana hasil perintah diterapkan ke DataRow saat digunakan oleh metode UpdateOleDbDataAdapter.

Metode

Cancel()	Mencoba membatalkan eksekusi OleDbCommand.
Clone()	Membuat objek OleDbCommand baru yang merupakan salinan instans saat ini.
CreateDbParameter()	Membuat instans baru objek DbParameter. (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 baru objek OleDbParameter.
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola. (Diperoleh dari DbCommand)
Dispose(Boolean)	Merilis sumber daya yang tidak dikelola yang digunakan oleh DbCommand dan secara opsional merilis sumber daya terkelola. (Diperoleh dari DbCommand)
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 DbDataReader yang dapat digunakan untuk mengakses hasilnya. (Diperoleh dari DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Penyedia harus menerapkan metode ini untuk memberikan implementasi non-default untuk ExecuteReader kelebihan beban. Implementasi default memanggil metode ExecuteReader() sinkron 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. Memanggil ExecuteNonQueryAsync(CancellationToken) 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 ExecuteNonQuery() sinkron 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 panggil metode dan properti lain dari objek DbCommand hingga Tugas yang dikembalikan selesai. (Diperoleh dari DbCommand)
ExecuteReader()	Mengirim CommandText ke Connection dan membangun OleDbDataReader.
ExecuteReader(CommandBehavior)	Mengirim CommandText ke Connection, dan membangun OleDbDataReader menggunakan salah satu nilai CommandBehavior.
ExecuteReaderAsync()	Versi asinkron ExecuteReader, yang menjalankan perintah terhadap koneksinya, mengembalikan DbDataReader yang dapat digunakan untuk mengakses hasilnya. Memanggil ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) dengan CancellationToken.None. (Diperoleh dari DbCommand)
ExecuteReaderAsync(CancellationToken)	Versi asinkron ExecuteReader, yang menjalankan perintah terhadap koneksinya, mengembalikan DbDataReader yang dapat digunakan untuk mengakses hasilnya. Memanggil ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Diperoleh dari DbCommand)
ExecuteReaderAsync(CommandBehavior)	Versi asinkron ExecuteReader, yang menjalankan perintah terhadap koneksinya, mengembalikan DbDataReader yang dapat digunakan untuk mengakses hasilnya. Memanggil ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Diperoleh dari DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Memanggil ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (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 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. Memanggil ExecuteScalarAsync(CancellationToken) 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 ExecuteScalar() sinkron 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 panggil metode dan properti lain dari objek DbCommand hingga Tugas yang dikembalikan selesai. (Diperoleh dari DbCommand)
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 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)
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 properti CommandTimeout ke nilai default.
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)

Implementasi Antarmuka Eksplisit

ICloneable.Clone()	Untuk deskripsi anggota ini, lihat Clone().
IDbCommand.Connection	Mendapatkan atau mengatur IDbConnection yang digunakan oleh instans IDbCommandini. (Diperoleh dari DbCommand)
IDbCommand.CreateParameter()	Membuat instans baru objek IDbDataParameter. (Diperoleh dari DbCommand)
IDbCommand.ExecuteReader()	Untuk deskripsi anggota ini, lihat ExecuteReader().
IDbCommand.ExecuteReader(CommandBehavior)	Menjalankan CommandText terhadap Connection, dan membangun IDataReader menggunakan salah satu nilai CommandBehavior.
IDbCommand.Parameters	Mendapatkan IDataParameterCollection. (Diperoleh dari DbCommand)
IDbCommand.Transaction	Mendapatkan atau mengatur DbTransaction tempat objek DbCommand ini dijalankan. (Diperoleh dari DbCommand)

Metode Ekstensi

ConfigureAwait(IAsyncDisposable, Boolean)

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

Lihat juga

• OleDbDataAdapter
• OleDbConnection
• Bekerja dengan Perintah