OleDbCommand.ExecuteReader メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
CommandTextをConnectionに送信し、OleDbDataReaderをビルドします。
オーバーロード
| 名前 | 説明 |
|---|---|
| ExecuteReader() |
CommandTextをConnectionに送信し、OleDbDataReaderをビルドします。 |
| ExecuteReader(CommandBehavior) |
CommandTextをConnectionに送信し、CommandBehavior値のいずれかを使用してOleDbDataReaderを構築します。 |
ExecuteReader()
- ソース:
- OleDbCommand.cs
- ソース:
- OleDbCommand.cs
- ソース:
- OleDbCommand.cs
- ソース:
- OleDbCommand.cs
CommandTextをConnectionに送信し、OleDbDataReaderをビルドします。
public:
System::Data::OleDb::OleDbDataReader ^ ExecuteReader();
public System.Data.OleDb.OleDbDataReader ExecuteReader();
override this.ExecuteReader : unit -> System.Data.OleDb.OleDbDataReader
member this.ExecuteReader : unit -> System.Data.OleDb.OleDbDataReader
Public Function ExecuteReader () As OleDbDataReader
戻り値
OleDbDataReader オブジェクト。
例外
接続が最初に参加していたコンテキストとは異なるトランザクション コンテキスト内でコマンドを実行することはできません。
例
次の例では、 OleDbCommandを作成し、SQL SELECT ステートメントである文字列と、データ ソースへの接続に使用する文字列を渡して実行します。
public void CreateReader(string connectionString, string queryString)
{
using (OleDbConnection connection = new OleDbConnection(connectionString))
{
OleDbCommand command = new OleDbCommand(queryString, connection);
connection.Open();
OleDbDataReader reader = command.ExecuteReader();
while (reader.Read())
{
Console.WriteLine(reader[0].ToString());
}
reader.Close();
}
}
Public Sub CreateReader(ByVal connectionString As String, _
ByVal queryString As String)
Using connection As New OleDbConnection(connectionString)
Dim command As New OleDbCommand(queryString, connection)
connection.Open()
Dim reader As OleDbDataReader = command.ExecuteReader()
While reader.Read()
Console.WriteLine(reader(0).ToString())
End While
reader.Close()
End Using
End Sub
注釈
CommandType プロパティが StoredProcedure に設定されている場合、CommandText プロパティはストアド プロシージャの名前に設定する必要があります。 このコマンドは、 ExecuteReaderを呼び出すときにこのストアド プロシージャを実行します。
OleDbConnectionを閉じる前に、まずOleDbDataReader オブジェクトを閉じます。 OleDbCommand オブジェクトを再利用する場合は、OleDbDataReader オブジェクトも閉じる必要があります。
こちらもご覧ください
適用対象
ExecuteReader(CommandBehavior)
- ソース:
- OleDbCommand.cs
- ソース:
- OleDbCommand.cs
- ソース:
- OleDbCommand.cs
- ソース:
- OleDbCommand.cs
CommandTextをConnectionに送信し、CommandBehavior値のいずれかを使用してOleDbDataReaderを構築します。
public:
System::Data::OleDb::OleDbDataReader ^ ExecuteReader(System::Data::CommandBehavior behavior);
public System.Data.OleDb.OleDbDataReader ExecuteReader(System.Data.CommandBehavior behavior);
override this.ExecuteReader : System.Data.CommandBehavior -> System.Data.OleDb.OleDbDataReader
member this.ExecuteReader : System.Data.CommandBehavior -> System.Data.OleDb.OleDbDataReader
Public Function ExecuteReader (behavior As CommandBehavior) As OleDbDataReader
パラメーター
- behavior
- CommandBehavior
CommandBehavior値の 1 つ。
戻り値
OleDbDataReader オブジェクト。
例外
接続が最初に参加していたコンテキストとは異なるトランザクション コンテキスト内でコマンドを実行することはできません。
例
次の例では、 OleDbCommandを作成し、Transact-SQL SELECT ステートメントである文字列と、データ ソースへの接続に使用する文字列を渡して実行します。 CommandBehavior は CloseConnection に設定されます。
public void CreateMyOleDbDataReader(string queryString,string connectionString)
{
OleDbConnection connection = new OleDbConnection(connectionString);
OleDbCommand command = new OleDbCommand(queryString, connection);
connection.Open();
OleDbDataReader reader = command.ExecuteReader(CommandBehavior.CloseConnection);
while(reader.Read())
{
Console.WriteLine(reader.GetString(0));
}
reader.Close();
//Implicitly closes the connection because CommandBehavior.CloseConnection was specified.
}
Public Sub CreateMyOleDbDataReader(queryString As String, _
connectionString As String)
Dim connection As New OleDbConnection(connectionString)
Dim command As New OleDbCommand(queryString, connection)
connection.Open()
Dim reader As OleDbDataReader = command.ExecuteReader(CommandBehavior.CloseConnection)
While reader.Read()
Console.WriteLine(reader.GetString(0))
End While
reader.Close()
'Implicitly closes the connection because CommandBehavior.CloseConnection was specified.
End Sub
注釈
OleDbCommand オブジェクトのExecuteReader メソッドでSingleRowを指定すると、.NET Framework Data Provider for OLE DB は OLE DB IRow インターフェイスを使用してバインドを実行します (使用可能な場合)。 それ以外の場合は、 IRowset インターフェイスを使用します。 SQL ステートメントが 1 行のみを返すと予想される場合は、 SingleRow を指定すると、アプリケーションのパフォーマンスも向上する可能性があります。
CommandType プロパティが StoredProcedure に設定されている場合、CommandText プロパティはストアド プロシージャの名前に設定する必要があります。 このコマンドは、 ExecuteReaderを呼び出すときにこのストアド プロシージャを実行します。
OleDbDataReaderでは、大きなバイナリ値を効率的に読み取ることができる特別なモードがサポートされています。 詳細については、CommandBehaviorのSequentialAccess設定を参照してください。
OleDbConnectionを閉じる前に、まずOleDbDataReader オブジェクトを閉じます。
OleDbCommand オブジェクトを再利用する場合は、OleDbDataReader オブジェクトも閉じる必要があります。
CommandBehaviorが CloseConnection に設定された状態でOleDbDataReaderが作成された場合、OleDbDataReaderを閉じると接続が自動的に閉じます。