SqlBatch Kelas

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v7.1.0

public ref class SqlBatch : IAsyncDisposable, IDisposable

public class SqlBatch : IAsyncDisposable, IDisposable

type SqlBatch = class
    interface IDisposable
    interface IAsyncDisposable

Public Class SqlBatch
Implements IAsyncDisposable, IDisposable

Warisan

Object

SqlBatch

Penerapan

IAsyncDisposable IDisposable

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 SqlConnection saat using 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();

        using 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);
        }

        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));
    }
}

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 SqlConnection saat using 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();

        using 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);
        }

        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

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

Properti

Nama	Deskripsi
BatchCommands	Daftar perintah yang terkandung dalam batch dalam .SqlBatchCommandCollection
Commands	Daftar SqlBatchCommand yang terkandung dalam batch dalam .List<T>
Connection	Mendapatkan atau mengatur yang SqlConnection digunakan oleh instans ini dari SqlBatch.
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 tempat SqlTransactionSqlBatch perintah dijalankan.

Metode

Nama	Deskripsi
Cancel()	Mencoba membatalkan eksekusi SqlBatch.
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola.
DisposeAsync()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola secara asinkron.
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 panggil metode dan properti DbCommand objek lainnya hingga Tugas yang dikembalikan selesai.
ExecuteReader()	Commands Mengirim ke Connection dan membangun SqlDataReader.
ExecuteReader(CommandBehavior)	Commands Mengirim ke Connection dan membangun SqlDataReader.
ExecuteReaderAsync(CancellationToken)	Versi asinkron dari ExecuteReader(), yang mengirim Commands ke Connection dan membangun SqlDataReader. Pengecualian akan dilaporkan melalui objek Tugas yang dikembalikan.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Versi asinkron dari ExecuteReader(), yang mengirim 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.