Bagikan melalui


IDbCommand Antarmuka

Definisi

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 Command objek penyedia data .NET dijalankan.

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 Connection objek penyedia data .NET, dan mengembalikan jumlah baris yang terpengaruh.

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.

Berlaku untuk

Lihat juga