SqlDataReader クラス

定義

public ref class SqlDataReader : System::Data::Common::DbDataReader, IDisposable

public ref class SqlDataReader : System::Data::Common::DbDataReader, IDisposable, System::Data::Common::IDbColumnSchemaGenerator

public ref class SqlDataReader : System::Data::Common::DbDataReader

public class SqlDataReader : System.Data.Common.DbDataReader, IDisposable

public class SqlDataReader : System.Data.Common.DbDataReader, IDisposable, System.Data.Common.IDbColumnSchemaGenerator

public class SqlDataReader : System.Data.Common.DbDataReader

type SqlDataReader = class
    inherit DbDataReader
    interface IDataReader
    interface IDisposable
    interface IDataRecord

type SqlDataReader = class
    inherit DbDataReader
    interface IDataReader
    interface IDataRecord
    interface IDisposable

type SqlDataReader = class
    inherit DbDataReader
    interface IDbColumnSchemaGenerator
    interface IDisposable

type SqlDataReader = class
    inherit DbDataReader
    interface IDbColumnSchemaGenerator
    interface IDataReader
    interface IDataRecord
    interface IDisposable

type SqlDataReader = class
    inherit DbDataReader
    interface IDisposable

Public Class SqlDataReader
Inherits DbDataReader
Implements IDisposable

Public Class SqlDataReader
Inherits DbDataReader
Implements IDbColumnSchemaGenerator, IDisposable

Public Class SqlDataReader
Inherits DbDataReader

継承

DbDataReader

SqlDataReader

実装

IDataReader IDataRecord IDisposable IDbColumnSchemaGenerator

例

次の例では、 、 SqlConnection、 SqlCommandおよび を作成します SqlDataReader。 この例では、データを読み取り、コンソール ウィンドウに書き込みます。 その後、コードは を SqlDataReader閉じます。 は SqlConnection 、コード ブロックの末尾で自動的に using 閉じられます。

using Microsoft.Data.SqlClient;

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

    private static void ReadOrderData(string connectionString)
    {
        string queryString =
            "SELECT OrderID, CustomerID FROM dbo.Orders;";

        using (SqlConnection connection =
                   new SqlConnection(connectionString))
        {
            SqlCommand command =
                new SqlCommand(queryString, connection);
            connection.Open();

            SqlDataReader reader = command.ExecuteReader();

            // Call Read before accessing data.
            while (reader.Read())
            {
                ReadSingleRow((IDataRecord)reader);
            }

            // Call Close when done reading.
            reader.Close();
        }
    }

    private static void ReadSingleRow(IDataRecord record)
    {
        Console.WriteLine(String.Format("{0}, {1}", record[0], record[1]));
    }

}

注釈

を SqlDataReader作成するには、コンストラクターを ExecuteReader 直接使用するのではなく、 オブジェクトの SqlCommand メソッドを呼び出す必要があります。

SqlDataReaderが使用されている間、関連付けられている SqlConnection は を処理SqlDataReader中であり、閉じる以外に に対して他の操作をSqlConnection実行することはできません。 これは、 の メソッドSqlDataReaderがClose呼び出されるまでの場合です。 たとえば、 を呼び出 Closeすまで出力パラメーターを取得することはできません。

データが読み取られている間に別のプロセスまたはスレッドによって結果セットに加えられた変更は、SqlDataReader のユーザーに表示される場合がありますが、 正確な動作は、タイミングに応じて変わります。

IsClosed が閉じた後に呼び出すことができるプロパティは、RecordsAffected と SqlDataReader だけです。 がRecordsAffected存在する間SqlDataReaderは プロパティにアクセスできますが、 の値RecordsAffectedを返す前に 常に を呼び出Closeして、正確な戻り値を保証します。

シーケンシャル アクセス (CommandBehavior.SequentialAccess) を InvalidOperationException 使用する場合、位置が高度で、前の列で別の SqlDataReader 読み取り操作が試行されると、 が発生します。

プロパティ

メソッド

明示的なインターフェイスの実装

適用対象