SqlCommand.ExecuteReader メソッド

リファレンス

定義

名前空間:: System.Data.SqlClient

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

アセンブリ:: System.Data.dll

パッケージ:: System.Data.SqlClient v4.8.6

重要

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

CommandText を Connection に送信し、SqlDataReader を構築します。

オーバーロード

ExecuteReader()	CommandText を Connection に送信し、SqlDataReader を構築します。
ExecuteReader(CommandBehavior)	CommandText を Connection に送信し、CommandBehavior 値のいずれかを使用して SqlDataReader を構築します。

ExecuteReader()

CommandText を Connection に送信し、SqlDataReader を構築します。

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

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

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

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

Public Function ExecuteReader () As SqlDataReader

戻り値

SqlDataReader

SqlDataReader オブジェクト。

例外

InvalidCastException

Value が Stream に設定されたときに、Binary でも VarBinary でもない SqlDbType が使用されました。ストリーミングの詳細については、「SqlClient ストリーミングサポート」を参照してください。

- または -

SqlDbTypeがにTextReader設定されている場合Value、Char、NChar、NVarChar、VarChar、または Xml 以外のが使用されました。

- または -

Value が XmlReader に設定されたときに、Xml 以外の SqlDbType が使用されました。

SqlException

ロックされた行に対するコマンドの実行中に、例外が発生しました。 Microsoft .NET Framework バージョン 1.0 を使用している場合は、この例外は生成されません。

- または -

ストリーミング操作中にタイムアウトが発生しました。ストリーミングの詳細については、「SqlClient ストリーミングサポート」を参照してください。

InvalidOperationException

現在の接続の状態は "終了" です。 ExecuteReader() には開いている SqlConnection が必要です。

- または -

ストリーミング操作中に、SqlConnection が閉じられたか切断されました。ストリーミングの詳細については、「SqlClient ストリーミングサポート」を参照してください。

IOException

ストリーミング操作中に、Stream、XmlReader、または TextReader オブジェクトでエラーが発生しました。ストリーミングの詳細については、「SqlClient ストリーミングサポート」を参照してください。

ObjectDisposedException

ストリーミング操作中に、Stream、XmlReader、または TextReader オブジェクトが閉じられました。ストリーミングの詳細については、「SqlClient ストリーミングサポート」を参照してください。

例

次の例では、を SqlCommand作成し、Transact-SQL SELECT ステートメントである文字列と、データソースへの接続に使用する文字列を渡して実行します。

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        connection.Open();

        SqlCommand command = new SqlCommand(queryString, connection);
        using(SqlDataReader reader = command.ExecuteReader())
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}", reader[0]));
            }
        }
    }
}

Public Sub CreateCommand(ByVal queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        connection.Open()

        Dim command As New SqlCommand(queryString, connection)
        Dim reader As SqlDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine("{0}", reader(0))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

注釈

CommandType プロパティが StoredProcedure に設定されている場合は、CommandText プロパティをストアドプロシージャの名前に設定します。 ExecuteReader を呼び出すときに、コマンドによってこのストアドプロシージャが実行されます。

Note

トランザクションがデッドロックされた場合は、が呼び出されるまで Read 例外がスローされない可能性があります。

複数のアクティブな結果セット (MARS) 機能を使用すると、同じ接続を使用して複数のアクションを実行できます。

または BeginExecuteReader を使用ExecuteReaderして XML データにアクセスする場合、SQL Serverは、それぞれ 2,033 文字の複数行で 2,033 文字を超える XML 結果を返します。この動作を回避するには、または BeginExecuteXmlReader を使用ExecuteXmlReaderして FOR XML クエリを読み取ります。

こちらもご覧ください

適用対象

ExecuteReader(CommandBehavior)

CommandText を Connection に送信し、CommandBehavior 値のいずれかを使用して SqlDataReader を構築します。

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

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

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

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

Public Function ExecuteReader (behavior As CommandBehavior) As SqlDataReader

パラメーター

behavior: CommandBehavior

CommandBehavior 値のいずれか 1 つ。

戻り値

SqlDataReader

SqlDataReader オブジェクト。

例外

InvalidCastException

- または -

SqlDbTypeがにTextReader設定されている場合Value、Char、NChar、NVarChar、VarChar、または Xml 以外のが使用されました。

- または -

Value が XmlReader に設定されたときに、Xml 以外の SqlDbType が使用されました。

SqlException

IOException

InvalidOperationException

ObjectDisposedException

例

次の例では、を SqlCommand作成し、Transact-SQL SELECT ステートメントである文字列と、データソースへの接続に使用する文字列を渡して実行します。 CommandBehavior が CloseConnection に設定されます。

private static void CreateCommand(string queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(queryString, connection);
        connection.Open();
        using(SqlDataReader reader =
            command.ExecuteReader(CommandBehavior.CloseConnection))
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}", reader[0]));
            }
        }
    }
}

Public Sub CreateCommand(ByVal queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()
        Dim reader As SqlDataReader = _
            command.ExecuteReader(CommandBehavior.CloseConnection)
        Try
            While reader.Read()
                Console.WriteLine("{0}", reader(0))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

注釈

Note

大きな値とバイナリデータを取得するには、を使用 SequentialAccess します。それ以外の場合は、 OutOfMemoryException が発生し、接続が閉じられます。

複数のアクティブな結果セット (MARS) 機能を使用すると、同じ接続を使用して複数のアクションを実行できます。

こちらもご覧ください

適用対象

SqlCommand.ExecuteReader メソッド

定義

オーバーロード

ExecuteReader()

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

ExecuteReader(CommandBehavior)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

フィードバック

その他のリソース