SqlBatch Kelas

Referensi

Definisi

Ruang nama:: Microsoft.Data.SqlClient

Rakitan:: Microsoft.Data.SqlClient.dll

Paket:: Microsoft.Data.SqlClient v5.2.0

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.

public ref class SqlBatch : System::Data::Common::DbBatch

public class SqlBatch : System.Data.Common.DbBatch

type SqlBatch = class
    inherit DbBatch

Public Class SqlBatch
Inherits DbBatch

Warisan: DbBatch
SqlBatch

Contoh

Contoh berikut membuat SqlConnection dan SqlBatch, lalu menambahkan beberapa SqlBatchCommand objek ke batch. Kemudian menjalankan batch, membuat SqlDataReader. Contohnya membaca hasil perintah batch, menulisnya ke konsol. Akhirnya, contoh menutup SqlDataReader dan kemudian saat SqlConnectionusing blok jatuh dari cakupan.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        string str = "Data Source=(local);Initial Catalog=Northwind;"
        + "Integrated Security=SSPI;Encrypt=False";
        RunBatch(str);
    }

    static void RunBatch(string connString)
    {
        using var connection = new SqlConnection(connString);
        connection.Open();

        var batch = new SqlBatch(connection);

        const int count = 10;
        const string parameterName = "parameter";
        for (int i = 0; i < count; i++)
        {
            var batchCommand = new SqlBatchCommand($"SELECT @{parameterName} as value");
            batchCommand.Parameters.Add(new SqlParameter(parameterName, i));
            batch.BatchCommands.Add(batchCommand);
        }

        // Optionally Prepare
        batch.Prepare();

        var results = new List<int>(count);
        using (SqlDataReader reader = batch.ExecuteReader())
        {
            do
            {
                while (reader.Read())
                {
                    results.Add(reader.GetFieldValue<int>(0));
                }
            } while (reader.NextResult());
        }
        Console.WriteLine(string.Join(", ", results));
    }
}

Konstruktor

SqlBatch()	Menginisialisasi baru SqlBatch.
SqlBatch(SqlConnection, SqlTransaction)	Menginisialisasi baru SqlBatch.

Properti

BatchCommands	Daftar perintah yang terkandung dalam batch dalam SqlBatchCommandCollection.
Commands	Daftar perintah yang terkandung dalam batch di IList objek SqlBatchCommand .
Connection	Mendapatkan atau mengatur yang SqlConnection digunakan oleh instans ini dari SqlBatch .
DbBatchCommands	Mendapatkan koleksi SqlBatchCommand objek.
DbConnection	Mendapatkan atau mengatur yang DbConnection digunakan oleh ini SqlBatch.
DbTransaction	Mendapatkan atau mengatur tempat SqlTransaction objek ini SqlBatch dijalankan.
Timeout	Mendapatkan atau mengatur waktu tunggu (dalam detik) sebelum mengakhiri upaya untuk menjalankan batch dan menghasilkan kesalahan.
Transaction	Mendapatkan atau mengatur di SqlTransaction SqlBatch mana perintah dijalankan.

Metode

Cancel()	Mencoba membatalkan eksekusi SqlBatch.
CreateDbBatchCommand()	Membuat instans SqlBatchCommand baru objek.
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola.
ExecuteDbDataReader(CommandBehavior)	Menjalankan batch terhadap koneksinya, mengembalikan SqlDataReader yang dapat digunakan untuk mengakses hasilnya.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Implementasi ini memanggil ExecuteReaderAsync() metode dan mengembalikan tugas yang selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika melewati token pembatalan yang sudah dibatalkan. Metode ini menerima token pembatalan yang dapat digunakan untuk meminta operasi dibatalkan lebih awal.
ExecuteNonQuery()	Menjalankan batch terhadap objek koneksinya, mengembalikan jumlah total baris yang terpengaruh di semua perintah batch.
ExecuteNonQueryAsync(CancellationToken)	Ini adalah versi asinkron dari ExecuteNonQuery(). Implementasi memanggil ExecuteNonQueryAsync(CancellationToken) metode dan mengembalikan tugas yang selesai. Implementasi default akan mengembalikan tugas yang dibatalkan jika melewati token pembatalan yang sudah dibatalkan. Jangan memanggil metode dan properti `DbCommand` objek lain sampai Tugas yang dikembalikan selesai.
ExecuteReader()	Commands Mengirim ke Connection dan membangun SqlDataReader .
ExecuteReaderAsync(CancellationToken)	Versi asinkron dari ExecuteReader() , yang mengirimkan Commands ke Connection dan membangun SqlDataReader. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.
ExecuteScalar()	Menjalankan batch dan mengembalikan kolom pertama dari baris pertama dalam tataan hasil pertama yang dikembalikan. Semua kolom, baris, dan hasil lainnya diabaikan.
ExecuteScalarAsync(CancellationToken)	Versi asinkron dari ExecuteScalar(), yang menjalankan batch dan mengembalikan kolom pertama dari baris pertama dalam tataan hasil pertama yang dikembalikan. Semua kolom, baris, dan tataan hasil lainnya diabaikan.
Prepare()	Membuat versi batch yang disiapkan (atau dikompilasi), atau dari setiap perintahnya, pada sumber data.
PrepareAsync(CancellationToken)	Secara asinkron membuat versi batch yang disiapkan (atau dikompilasi), atau dari setiap perintahnya, pada sumber data.

Berlaku untuk

Bagikan melalui