OleDbCommand.ExecuteReader メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
CommandText を Connection に送信し、OleDbDataReader を構築します。
オーバーロード
ExecuteReader() |
CommandText を Connection に送信し、OleDbDataReader を構築します。 |
ExecuteReader(CommandBehavior) |
CommandText を Connection に送信し、CommandBehavior 値のいずれかを使用して OleDbDataReader を構築します。 |
ExecuteReader()
- ソース:
- 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
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 ステートメントが単一行のみを返すことが予期される場合、SingleRow を指定すると、アプリケーションのパフォーマンスも向上します。
CommandType プロパティが StoredProcedure
に設定されている場合は、CommandText プロパティをストアド プロシージャの名前に設定します。
ExecuteReader を呼び出すときに、コマンドによってこのストアド プロシージャが実行されます。
OleDbDataReader は、大きなバイナリ値を効率的に読み取ることができるようにする特別なモードをサポートします。 詳細については、 の設定CommandBehaviorをSequentialAccess
参照してください。
を閉じる前に、 OleDbConnectionまず オブジェクトを OleDbDataReader 閉じます。 オブジェクトを再利用OleDbCommandするOleDbDataReader場合は、オブジェクトを閉じる必要もあります。 を OleDbDataReader に設定して CloseConnection
が作成された場合、 をOleDbDataReader閉じるとCommandBehavior、接続が自動的に閉じます。
こちらもご覧ください
適用対象
.NET