SqlDataReader クラス

定義

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

public ref class SqlDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader

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

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

public sealed class SqlDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader

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

type SqlDataReader = class
    inherit DbDataReader
    interface IDisposable

type SqlDataReader = class
    inherit MarshalByRefObject
    interface IEnumerable
    interface IDataReader
    interface IDisposable
    interface IDataRecord

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

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

Public Class SqlDataReader
Inherits DbDataReader
Implements IDisposable

Public NotInheritable Class SqlDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable

Public Class SqlDataReader
Inherits DbDataReader
Implements IDbColumnSchemaGenerator

継承

Object

DbDataReader

SqlDataReader

継承

Object

MarshalByRefObject

DbDataReader

SqlDataReader

継承

Object

MarshalByRefObject

SqlDataReader

実装

IDisposable IEnumerable IDataReader IDataRecord IDbColumnSchemaGenerator

例

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

using System;
using System.Data;
using System.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 dataRecord)
    {
        Console.WriteLine(String.Format("{0}, {1}", dataRecord[0], dataRecord[1]));
    }
}

Option Explicit On
Option Strict On

Imports System.Data
Imports System.Data.SqlClient

Module Module1

    Sub Main()
        Dim str As String = "Data Source=(local);Initial Catalog=Northwind;" _
       & "Integrated Security=SSPI;"
        ReadOrderData(str)
    End Sub

    Private Sub ReadOrderData(ByVal connectionString As String)
        Dim queryString As String = _
            "SELECT OrderID, CustomerID FROM dbo.Orders;"

        Using connection As New SqlConnection(connectionString)
            Dim command As New SqlCommand(queryString, connection)
            connection.Open()

            Dim reader As SqlDataReader = command.ExecuteReader()

            ' Call Read before accessing data.
            While reader.Read()
                ReadSingleRow(CType(reader, IDataRecord))
            End While

            ' Call Close when done reading.
            reader.Close()
        End Using
    End Sub

    Private Sub ReadSingleRow(ByVal record As IDataRecord)
       Console.WriteLine(String.Format("{0}, {1}", record(0), record(1)))

    End Sub

End Module

注釈

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

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

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

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

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

プロパティ

メソッド

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

拡張メソッド

適用対象

こちらもご覧ください

• DataAdapter と DataReader
• SQL Server と ADO.NET
• ADO.NET の概要