OdbcCommand Kelas

Definisi

Ruang nama:

System.Data.Odbc

Rakitan:

System.Data.Odbc.dll

Paket:

System.Data.Odbc v9.0.0-preview.3.24172.9

Sumber:

OdbcCommand.cs

Mewakili pernyataan SQL atau prosedur tersimpan untuk dijalankan terhadap sumber data. Kelas ini tidak dapat diwariskan.

public ref class OdbcCommand sealed : System::Data::Common::DbCommand, ICloneable

public sealed class OdbcCommand : System.Data.Common.DbCommand, ICloneable

type OdbcCommand = class
    inherit DbCommand
    interface ICloneable

Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable

Warisan

Object

MarshalByRefObject

Component

DbCommand

OdbcCommand

Penerapan

ICloneable

Contoh

Contoh berikut menggunakan ExecuteNonQuery.

public void InsertRow(string connectionString, string insertSQL)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        // The insertSQL string contains a SQL statement that
        // inserts a new row in the source table.
        OdbcCommand command = new OdbcCommand(insertSQL, connection);

        // Open the connection and execute the insert command.
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }

Public Sub InsertRow(ByVal connectionString As String, _
    ByVal insertSQL As String)

    Using connection As New OdbcConnection(connectionString)
        ' The insertSQL string contains a SQL statement that
        ' inserts a new row in the source table.
        Dim command As New OdbcCommand(insertSQL, connection)

        ' Open the connection and execute the insert command.
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

Keterangan

Kelas menyediakan OdbcCommand metode berikut untuk menjalankan perintah terhadap sumber data:

Item	Deskripsi
ExecuteReader	Menjalankan perintah yang mengembalikan baris.
ExecuteNonQuery	Menjalankan perintah seperti pernyataan SQL INSERT, DELETE, UPDATE, dan SET.
ExecuteScalar	Mengambil satu nilai, misalnya, nilai agregat, dari database.

Anda dapat mengatur ulang CommandText properti dan menggunakan OdbcCommand kembali objek. Namun, Anda harus menutup OdbcDataReader sebelum dapat menjalankan perintah baru atau sebelumnya.

Jika eksekusi perintah menyebabkan fatal OdbcException seperti tingkat keparahan SQL Server 20 atau lebih, OdbcConnection dapat ditutup. Namun, pengguna dapat membuka kembali koneksi dan melanjutkan.

Konstruktor

OdbcCommand()	Menginisialisasi instans baru kelas OdbcCommand.
OdbcCommand(String)	Menginisialisasi instans OdbcCommand baru kelas dengan teks kueri.
OdbcCommand(String, OdbcConnection)	Menginisialisasi instans OdbcCommand baru kelas dengan teks kueri dan OdbcConnection objek.
OdbcCommand(String, OdbcConnection, OdbcTransaction)	Menginisialisasi instans OdbcCommand baru kelas dengan teks kueri, OdbcConnection objek, 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 terhadap 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 OdbcConnection digunakan oleh instans ini dari OdbcCommand.
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 mengatur nilai yang menunjukkan apakah objek perintah harus terlihat dalam kontrol antarmuka yang disesuaikan.
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component)
Parameters	OdbcParameterCollectionMendapatkan .
Site	Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component)
Transaction	Mendapatkan atau mengatur tempat OdbcTransactionOdbcCommand eksekusi.
UpdatedRowSource	Mendapatkan atau menetapkan nilai yang menentukan bagaimana metode Pembaruan harus menerapkan hasil perintah ke DataRow.

Metode

Cancel()	Mencoba membatalkan eksekusi OdbcCommand.
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 OdbcParameter baru objek.
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, melepaskan, atau mereset sumber daya yang tidak terkelola. (Diperoleh dari DbCommand)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang DbCommand digunakan oleh 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 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 DbCommand objek sampai Tugas yang dikembalikan selesai. (Diperoleh dari DbCommand)
ExecuteReader()	CommandText Mengirim ke Connection dan membangun OdbcDataReader.
ExecuteReader(CommandBehavior)	CommandText Mengirim ke Connection, dan membangun OdbcDataReader 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 DbCommand objek sampai 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 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)
Prepare()	Membuat versi perintah yang disiapkan atau dikompilasi di 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()	Membuat instans IDbDataParameter baru objek. (Diperoleh dari DbCommand)
IDbCommand.ExecuteReader()	CommandText Menjalankan terhadap Connection dan membangun IDataReader. (Diperoleh dari DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	CommandText Menjalankan terhadap Connection, dan membangun IDataReader menggunakan salah CommandBehavior satu nilai. (Diperoleh dari DbCommand)
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.

Lihat juga

• OdbcDataAdapter
• OdbcConnection
• Menjalankan Perintah