SqlBatch.ExecuteReader メソッド

定義

名前空間:: Microsoft.Data.SqlClient

アセンブリ:: Microsoft.Data.SqlClient.dll

パッケージ:: Microsoft.Data.SqlClient v7.1.0

パッケージ:: Microsoft.Data.SqlClient v5.2.0

パッケージ:: Microsoft.Data.SqlClient v6.0.2

パッケージ:: Microsoft.Data.SqlClient v6.1.3

パッケージ:: Microsoft.Data.SqlClient v7.0.3

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

Name	説明
ExecuteReader()	CommandsをConnectionに送信し、SqlDataReaderをビルドします。
ExecuteReader(CommandBehavior)	CommandsをConnectionに送信し、SqlDataReaderをビルドします。

ExecuteReader()

ソース:: SqlBatch.cs

CommandsをConnectionに送信し、SqlDataReaderをビルドします。

public:
 Microsoft::Data::SqlClient::SqlDataReader ^ ExecuteReader();

public Microsoft.Data.SqlClient.SqlDataReader ExecuteReader();

member this.ExecuteReader : unit -> Microsoft.Data.SqlClient.SqlDataReader

override this.ExecuteReader : unit -> Microsoft.Data.SqlClient.SqlDataReader

Public Function ExecuteReader () As SqlDataReader

返品

SqlDataReader

例

次の例では、 SqlConnection と SqlBatchを作成し、バッチに複数の SqlBatchCommand オブジェクトを追加します。その後、バッチが実行され、 SqlDataReaderが作成されます。この例では、バッチコマンドの結果を読み取り、コンソールに書き込みます。最後に、SqlDataReaderを閉じ、using ブロックがスコープから外れるので、SqlConnectionを閉じます。

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

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

適用対象

ExecuteReader(CommandBehavior)

CommandsをConnectionに送信し、SqlDataReaderをビルドします。

public:
 Microsoft::Data::SqlClient::SqlDataReader ^ ExecuteReader(System::Data::CommandBehavior behavior);

public Microsoft.Data.SqlClient.SqlDataReader ExecuteReader(System.Data.CommandBehavior behavior);

member this.ExecuteReader : System.Data.CommandBehavior -> Microsoft.Data.SqlClient.SqlDataReader

override this.ExecuteReader : System.Data.CommandBehavior -> Microsoft.Data.SqlClient.SqlDataReader

Public Function ExecuteReader (behavior As CommandBehavior) As SqlDataReader

パラメーター

behavior: CommandBehavior

バッチ実行とデータ取得のオプションを指定する CommandBehaviorのインスタンス。バッチレベルでは、 SequentialAccess と CloseConnection のみがサポートされます。

返品

SqlDataReader

例

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(CommandBehavior.CloseConnection))
        {
            do
            {
                while (reader.Read())
                {
                    results.Add(reader.GetFieldValue<int>(0));
                }
            } while (reader.NextResult());
        }
        Console.WriteLine(string.Join(", ", results));
    }
}

適用対象