IDataReader インターフェイス
データ ソースでコマンドを実行して取得した結果セットの、1 つ以上の前方向ストリームを読み込む手段を提供します。リレーショナル データベースにアクセスする .NET Framework データ プロバイダによって実装されます。
この型のすべてのメンバの一覧については、IDataReader メンバ を参照してください。
Public Interface IDataReader
Inherits IDisposable, IDataRecord
[C#]
public interface IDataReader : IDisposable, IDataRecord
[C++]
public __gc __interface IDataReader : public IDisposable,
IDataRecord
[JScript]
public interface IDataReader implements IDisposable, IDataRecord
IDataReader を実装するクラス
| クラス | 説明 |
|---|---|
| OdbcDataReader | データ ソースからデータ行の前方向ストリームを読み取る方法を提供します。このクラスは継承できません。 |
| OleDbDataReader | データ ソースからデータ行の前方向ストリームを読み取る方法を提供します。このクラスは継承できません。 |
| OracleDataReader | データ ソースからデータ行の前方向ストリームを読み取る方法を提供します。このクラスは継承できません。 |
| SqlCeDataReader | データ ソースからデータ行の前方向ストリームを読み取る方法を提供します。このクラスは継承できません。 |
| SqlDataReader | SQL Server データベースから行の前方向ストリームを読み取る方法を提供します。このクラスは継承できません。 |
解説
IDataReader インターフェイスと IDataRecord インターフェイスを使用すると、継承クラスは結果セットの 1 つ以上の前方向ストリームを読み込む手段を提供している DataReader クラスを実装できます。DataReader クラスの詳細については、「 DataReader によるデータの取得 」を参照してください。.NET Framework データ プロバイダの実装の詳細については、「 .NET Framework データ プロバイダの実装 」を参照してください。
アプリケーションでは IDataReader インターフェイスのインスタンスは直接作成されず、 IDataReader を継承するクラスのインスタンスが作成されます。
IDataReader を継承するクラスは、継承されたメンバを実装する必要があり、通常、プロバイダ固有の機能を追加する追加メンバを定義する必要があります。
データを読み込み中に別のプロセスまたはスレッドによって結果セットが変更された場合は、 IDataReader を実装するクラスのユーザーに対してその変更を表示できる場合があります。ただし、正確な動作はプロバイダとタイミングによって異なります。
実装時の注意: .NET Framework データ プロバイダ間に一貫性を持たせるために、継承クラスには Prv Command という形式の名前を付けてください。 Prv は各 .NET Framework データ プロバイダの名前空間内のすべてのクラスに付けられるプリフィックスです。たとえば、 Sql は System.Data.SqlClient 名前空間内の SqlDataAdapter クラスのプリフィックスです。
ユーザーは DataReader クラスのインスタンスを直接作成しません。その代わり、Command オブジェクトの ExecuteReader メソッドを使用して DataReader を取得します。このため、DataReader コンストラクタに内部マークを付ける必要があります。
使用例
[Visual Basic, C#, C++] 派生クラス SqlConnection 、 SqlCommand 、および SqlDataReader のインスタンスを作成する例を次に示します。この例では、データを読み取り、コンソールに出力します。最後に、この例では SqlDataReader を閉じてから、 SqlConnection を閉じます。
Public Sub ReadMyData(myConnString As String)
Dim mySelectQuery As String = "SELECT OrderID, CustomerID FROM Orders"
Dim myConnection As New SqlConnection(myConnString)
Dim myCommand As New SqlCommand(mySelectQuery, myConnection)
myConnection.Open()
Dim myReader As SqlDataReader
myReader = myCommand.ExecuteReader()
' Always call Read before accessing data.
While myReader.Read()
Console.WriteLine((myReader.GetInt32(0) & ", " & myReader.GetString(1)))
End While
' always call Close when done reading.
myReader.Close()
' Close the connection when done with it.
myConnection.Close()
End Sub 'ReadMyData
[C#]
public void ReadMyData(string myConnString) {
string mySelectQuery = "SELECT OrderID, CustomerID FROM Orders";
SqlConnection myConnection = new SqlConnection(myConnString);
SqlCommand myCommand = new SqlCommand(mySelectQuery,myConnection);
myConnection.Open();
SqlDataReader myReader;
myReader = myCommand.ExecuteReader();
// Always call Read before accessing data.
while (myReader.Read()) {
Console.WriteLine(myReader.GetInt32(0) + ", " + myReader.GetString(1));
}
// always call Close when done reading.
myReader.Close();
// Close the connection when done with it.
myConnection.Close();
}
[C++]
public:
void ReadMyData(String* myConnString) {
String* mySelectQuery = S"SELECT OrderID, CustomerID FROM Orders";
SqlConnection* myConnection = new SqlConnection(myConnString);
SqlCommand* myCommand = new SqlCommand(mySelectQuery,myConnection);
myConnection->Open();
SqlDataReader* myReader;
myReader = myCommand->ExecuteReader();
// Always call Read before accessing data.
while (myReader->Read()) {
Console::WriteLine(S"{0}, {1}", __box(myReader->GetInt32(0)), myReader->GetString(1));
}
// always call Close when done reading.
myReader->Close();
// Close the connection when done with it.
myConnection->Close();
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
名前空間: System.Data
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET
アセンブリ: System.Data (System.Data.dll 内)