ExecuteReader メソッド (CommandBehavior)

CommandTextConnection に送信し、CommandBehavior 値のいずれかを使用して SqlCeDataReader を構築します。

名前空間:  System.Data.SqlServerCe
アセンブリ:  System.Data.SqlServerCe (System.Data.SqlServerCe.dll)

構文

'宣言
Public Function ExecuteReader ( _
    behavior As CommandBehavior _
) As SqlCeDataReader
'使用
Dim instance As SqlCeCommand
Dim behavior As CommandBehavior
Dim returnValue As SqlCeDataReader

returnValue = instance.ExecuteReader(behavior)
public SqlCeDataReader ExecuteReader(
    CommandBehavior behavior
)
public:
SqlCeDataReader^ ExecuteReader(
    CommandBehavior behavior
)
member ExecuteReader : 
        behavior:CommandBehavior -> SqlCeDataReader 
public function ExecuteReader(
    behavior : CommandBehavior
) : SqlCeDataReader

パラメーター

戻り値

型: System.Data.SqlServerCe. . :: . .SqlCeDataReader
SqlCeDataReader オブジェクト。

例外

例外 条件
InvalidOperationException

接続を登録した当初のトランザクション コンテキストとは異なるコンテキストでは、コマンドを実行できません。

説明

SqlCeDataReader は、サイズの大きいバイナリ値を効率的に読み取るための特別なモードをサポートします。詳細については、CommandBehavior の SequentialAccess 設定のトピックを参照してください。

SqlCeDataReader の使用中は、関連付けられた SqlCeConnection は、その SqlCeDataReader によって使用されるためビジー状態になります。この状態では、SqlCeDataReaderClose メソッドを呼び出すまで、SqlCeConnection に対して実行できるのは Close 操作だけです。

使用例

SqlCeCommand を作成し、SQL SELECT ステートメントと SqlCeConnection オブジェクトを渡して、このコマンドを実行する例を次に示します。CommandBehavior は、CloseConnection に設定されます。

Dim conn As New SqlCeConnection(connString)
Dim cmd As New SqlCeCommand("SELECT * FROM myTable", conn)

cmd.Connection.Open()
Dim rdr As SqlCeDataReader = Nothing

Try
    ' Execute the reader; make sure you alway close the 
    ' reader after you're done using it (ideally in the finally block)
    '
    rdr = cmd.ExecuteReader(CommandBehavior.CloseConnection)

    While rdr.Read()
        Console.WriteLine(rdr.GetString(0))
    End While
Finally
    ' Closing the reader will also close the associated connection
    '
    rdr.Close()
End Try
SqlCeConnection conn = new SqlCeConnection(connString);
SqlCeCommand cmd = new SqlCeCommand("SELECT * FROM myTable", conn);

cmd.Connection.Open();
SqlCeDataReader rdr = null;

try
{
    // Execute the reader; make sure you alway close the 
    // reader after you're done using it (ideally in the finally block)
    //
    rdr = cmd.ExecuteReader(CommandBehavior.CloseConnection);

    while (rdr.Read())
    {
        Console.WriteLine(rdr.GetString(0));
    }
}
finally
{
    // Closing the reader will also close the associated connection
    //
    rdr.Close();
}

関連項目

参照

SqlCeCommand クラス

SqlCeCommand メンバー

ExecuteReader オーバーロード

System.Data.SqlServerCe 名前空間