SqlCeCommand.ExecuteReaderとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

SqlCeCommand.ExecuteReader メソッド ()

CommandText を Connection に送信し、SqlCeDataReader を構築します。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文

Visual Basic (宣言)

Public Function ExecuteReader As
 SqlCeDataReader

Visual Basic (使用法)

Dim instance As SqlCeCommand
Dim returnValue As SqlCeDataReader

returnValue = instance.ExecuteReader

public SqlCeDataReader ExecuteReader ()

C++

public:
SqlCeDataReader^ ExecuteReader ()

public SqlCeDataReader ExecuteReader ()

JScript

public function ExecuteReader () : SqlCeDataReader

戻り値
SqlCeDataReader オブジェクト。

例外

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

解説

SqlCeDataReader の使用中は、関連付けられた SqlCeConnection は、その SqlCeDataReader によって使用されるためビジー状態になります。この状態では、同じ接続で複数のリーダーを作成できます。

使用例

SqlCeCommand を作成し、SQL SELECT ステートメントの文字列とデータソースに接続するための文字列を渡して、このコマンドを実行する例を、次に示します。

Visual Basic

Dim conn As SqlCeConnection = Nothing
Dim rdr As SqlCeDataReader = Nothing

Try
    conn = New SqlCeConnection(connStr)
    conn.Open()

    Dim cmd As New SqlCeCommand("SELECT
 * FROM myTable", conn)
    cmd.Connection.Open()

    rdr = cmd.ExecuteReader()

    While rdr.Read()
        Console.WriteLine(rdr.GetString(0))
    End While
Finally
    rdr.Close()
    conn.Close()
End Try

SqlCeConnection conn = null;
SqlCeDataReader rdr = null;

try
{
    conn = new SqlCeConnection(connStr);
    conn.Open();

    SqlCeCommand cmd = new SqlCeCommand("SELECT * FROM myTable",
 conn);
    cmd.Connection.Open();

    rdr = cmd.ExecuteReader();

    while (rdr.Read())
    {
        Console.WriteLine(rdr.GetString(0));
    }
}
finally
{
    rdr.Close();
    conn.Close();
}

.NET Framework のセキュリティ

直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlCeCommand クラス
SqlCeCommand メンバ
System.Data.SqlServerCe 名前空間

SqlCeCommand.ExecuteReader メソッド

CommandText を Connection に送信し、SqlCeDataReader を構築します。
オーバーロードの一覧

名前	説明
SqlCeCommand.ExecuteReader ()	CommandText を Connection に送信し、SqlCeDataReader を構築します。 .NET Compact Framework によってサポートされています。
SqlCeCommand.ExecuteReader (CommandBehavior)	CommandText を Connection に送信し、CommandBehavior 値のいずれかを使用して SqlCeDataReader を構築します。 .NET Compact Framework によってサポートされています。

参照

SqlCeCommand.ExecuteReader メソッド (CommandBehavior)

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

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文

Visual Basic (宣言)

Public Function ExecuteReader ( _
    behavior As CommandBehavior _
) As SqlCeDataReader

Visual Basic (使用法)

Dim instance As SqlCeCommand
Dim behavior As CommandBehavior
Dim returnValue As SqlCeDataReader

returnValue = instance.ExecuteReader(behavior)

public SqlCeDataReader ExecuteReader (
    CommandBehavior behavior
)

C++

public:
SqlCeDataReader^ ExecuteReader (
    CommandBehavior behavior
)

public SqlCeDataReader ExecuteReader (
    CommandBehavior behavior
)

JScript

public function ExecuteReader (
    behavior : CommandBehavior
) : SqlCeDataReader

パラメータ

behavior: CommandBehavior 値の 1 つ。

戻り値
SqlCeDataReader オブジェクト。

例外

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

解説

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

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

使用例

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

Visual Basic

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();
}