SqlBatch Classe

Referência

Definição

Namespace:: Microsoft.Data.SqlClient

Assembly:: Microsoft.Data.SqlClient.dll

Pacote:: Microsoft.Data.SqlClient v5.2.0

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Herança: DbBatch
SqlBatch

Exemplos

O exemplo a seguir cria um SqlConnection e um SqlBatch, em seguida, adiciona vários SqlBatchCommand objetos ao lote. Em seguida, ele executa o lote, criando um SqlDataReader. O exemplo lê os resultados dos comandos do lote, gravando-os no console. Por fim, o exemplo fecha o SqlDataReader e, em seguida, o SqlConnection como os using blocos caem fora do escopo.

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

Construtores

SqlBatch()	Inicializa um novo SqlBatch.
SqlBatch(SqlConnection, SqlTransaction)	Inicializa um novo SqlBatch.

Propriedades

BatchCommands	A lista de comandos contidos no lote em um SqlBatchCommandCollection.
Commands	A lista de comandos contidos no lote em um IList dos SqlBatchCommand objetos.
Connection	Obtém ou define o SqlConnection usado por esta instância do SqlBatch .
DbBatchCommands	Obtém a coleção de objetos SqlBatchCommand.
DbConnection	Obtém ou define o DbConnection usado pelo SqlBatch.
DbTransaction	Obtém ou define o SqlBatch em que este objeto SqlTransaction é executado.
Timeout	Obtém ou define o tempo de espera (em segundos) antes de encerrar a tentativa de executar o lote e gerar um erro.
Transaction	Obtém ou define o dentro do SqlTransaction qual os SqlBatch comandos são executados.

Métodos

Cancel()	Tenta cancelar a execução de um SqlBatch.
CreateDbBatchCommand()	Cria uma nova instância de um objeto SqlBatchCommand.
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados.
ExecuteDbDataReader(CommandBehavior)	Executa o lote em sua conexão, retornando um SqlDataReader que pode ser usado para acessar os resultados.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Essa implementação invoca o ExecuteReaderAsync() método e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se já tiver passado um token de cancelamento. Esse método aceita um token de cancelamento que pode ser usado para solicitar a operação a ser cancelada no início.
ExecuteNonQuery()	Executa o lote em relação ao objeto de conexão, retornando o número total de linhas afetadas em todos os comandos do lote.
ExecuteNonQueryAsync(CancellationToken)	Essa é a versão assíncrona de ExecuteNonQuery(). A implementação invoca o ExecuteNonQueryAsync(CancellationToken) método e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se já tiver passado um token de cancelamento. Não invoque outros métodos e propriedades do objeto `DbCommand` até a Tarefa retornada ser concluída.
ExecuteReader()	Envia o Commands para o Connection e cria um SqlDataReader .
ExecuteReaderAsync(CancellationToken)	Uma versão assíncrona do ExecuteReader() , que envia o Commands para o Connection e cria um SqlDataReader. As exceções serão relatadas por meio do objeto de tarefa.
ExecuteScalar()	Executa o lote e retorna a primeira coluna da primeira linha no primeiro conjunto de resultados retornado. Todas as outras colunas, linhas e conjuntos de resultados são ignorados.
ExecuteScalarAsync(CancellationToken)	Uma versão assíncrona do ExecuteScalar(), que executa o lote e retorna a primeira coluna da primeira linha no primeiro conjunto de resultados retornado. Todas as outras colunas, linhas e conjuntos de resultados são ignorados.
Prepare()	Cria uma versão preparada (ou compilada) do lote, ou de cada um de seus comandos, na fonte de dados.
PrepareAsync(CancellationToken)	Cria de forma assíncrona uma versão preparada (ou compilada) do lote, ou de cada um de seus comandos, na fonte de dados.

Aplica-se a

Partilhar via