IDbCommand Antarmuka
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 yang dijalankan saat terhubung ke sumber data, dan diimplementasikan oleh penyedia data .NET yang mengakses database relasional.
public interface class IDbCommand : IDisposable
public interface IDbCommand : IDisposable
type IDbCommand = interface
interface IDisposable
Public Interface IDbCommand
Implements IDisposable
- Turunan
- Penerapan
Contoh
Contoh berikut membuat instans kelas turunan, , SqlConnection, SqlCommanddan SqlDataReader. Contohnya membaca data, menulisnya ke konsol. Akhirnya, contoh menutup SqlDataReader, lalu SqlConnection.
private static void ReadOrderData(string connectionString)
{
string queryString =
"SELECT OrderID, CustomerID FROM dbo.Orders;";
using (SqlConnection connection = new SqlConnection(
connectionString))
{
SqlCommand command = new SqlCommand(
queryString, connection);
connection.Open();
using(SqlDataReader reader = command.ExecuteReader())
{
while (reader.Read())
{
Console.WriteLine(String.Format("{0}, {1}",
reader[0], reader[1]));
}
}
}
}
Public Sub ReadOrderData(ByVal connectionString As String)
Dim queryString As String = _
"SELECT OrderID, CustomerID FROM dbo.Orders;"
Using connection As New SqlConnection(connectionString)
Dim command As New SqlCommand(queryString, connection)
connection.Open()
Dim reader As SqlDataReader = command.ExecuteReader()
Try
While reader.Read()
Console.WriteLine(String.Format("{0}, {1}", _
reader(0), reader(1)))
End While
Finally
' Always call Close when done reading.
reader.Close()
End Try
End Using
End Sub
Keterangan
Antarmuka IDbCommand memungkinkan kelas pewarisan untuk mengimplementasikan kelas Perintah, yang mewakili pernyataan SQL yang dijalankan pada sumber data. Untuk informasi selengkapnya tentang kelas Perintah, lihat Menjalankan Perintah.
Aplikasi tidak membuat instans IDbCommand antarmuka secara langsung, tetapi membuat instans kelas yang mengimplementasikan IDbCommand antarmuka.
Kelas yang menerapkan harus mengimplementasikan IDbCommand semua anggotanya, dan biasanya menentukan anggota tambahan untuk menambahkan fungsionalitas khusus penyedia. Misalnya, IDbCommand antarmuka menentukan ExecuteNonQuery metode . Pada gilirannya SqlCommand , kelas mewarisi metode ini, dan juga mendefinisikan ExecuteXmlReader metode .
Catatan Bagi Implementer
Untuk mempromosikan konsistensi di antara penyedia data .NET Framework, beri nama kelas pewarisan dalam bentuk PrvClassname
di mana Prv
adalah awalan seragam yang diberikan kepada semua kelas di namespace layanan penyedia data .NET Framework tertentu. Misalnya, Sql
adalah awalan SqlCommand kelas di System.Data.SqlClient
namespace layanan.
Saat mewarisi dari IDbCommand antarmuka, Anda harus mengimplementasikan konstruktor berikut:
Item | Deskripsi |
---|---|
PrvCommand() | Menginisialisasi instans baru kelas PrvCommand. |
PrvCommand(string cmdText) | Menginisialisasi instans baru kelas PrvCommand dengan teks kueri. |
PrvCommand(string cmdText, koneksi PrvConnection) | Menginisialisasi instans baru kelas PrvCommand dengan teks kueri dan PrvConnection. |
PrvCommand(string cmdText, koneksi PrvConnection, transaksi PrvTransaction) | Menginisialisasi instans baru kelas PrvCommand dengan teks kueri, PrvConnection, dan PrvTransaction. |
Properti
CommandText |
Mendapatkan atau mengatur perintah teks untuk dijalankan terhadap sumber data. |
CommandTimeout |
Mendapatkan atau mengatur waktu tunggu (dalam detik) sebelum mengakhiri upaya untuk menjalankan perintah dan menghasilkan kesalahan. |
CommandType |
Menunjukkan atau menentukan bagaimana properti ditafsirkan CommandText . |
Connection |
Mendapatkan atau mengatur yang IDbConnection digunakan oleh instans ini dari IDbCommand. |
Parameters |
IDataParameterCollectionMendapatkan . |
Transaction |
Mendapatkan atau mengatur transaksi tempat |
UpdatedRowSource |
Mendapatkan atau mengatur bagaimana hasil perintah diterapkan ke DataRow saat digunakan oleh Update(DataSet) metode DbDataAdapter. |
Metode
Cancel() |
Upaya untuk membatalkan eksekusi IDbCommand. |
CreateParameter() |
Membuat instans IDbDataParameter baru objek. |
Dispose() |
Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, melepaskan, atau mereset sumber daya yang tidak terkelola. (Diperoleh dari IDisposable) |
ExecuteNonQuery() |
Menjalankan pernyataan SQL terhadap |
ExecuteReader() |
CommandText Menjalankan terhadap Connection dan membangun IDataReader. |
ExecuteReader(CommandBehavior) |
CommandText Menjalankan terhadap Connection, dan membangun IDataReader menggunakan salah CommandBehavior satu nilai. |
ExecuteScalar() |
Menjalankan kueri, dan mengembalikan kolom pertama dari baris pertama dalam hasil yang dikembalikan oleh kueri. Kolom atau baris tambahan diabaikan. |
Prepare() |
Membuat versi perintah yang disiapkan (atau dikompilasi) pada sumber data. |