SqlCeCommand.ExecuteReader Method ()

Article
10/22/2009

Sends the CommandText to the Connection and builds a SqlCeDataReader.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Syntax

'Declaration
Public Function ExecuteReader As SqlCeDataReader

public SqlCeDataReader ExecuteReader ()

public:
SqlCeDataReader^ ExecuteReader ()

public SqlCeDataReader ExecuteReader ()

public function ExecuteReader () : SqlCeDataReader

Return Value

A SqlCeDataReader object.

Exceptions

Exception type	Condition
InvalidOperationException	Cannot execute a command within a transaction context that differs from the context in which the connection was originally enlisted.

Remarks

While the SqlCeDataReader is in use, the associated SqlCeConnection is busy serving the SqlCeDataReader. In this state, you can create multiple readers in the same connection.

Example

The following example creates a SqlCeCommand and then executes it by passing a string that is an SQL SELECT statement and a string for connecting to the data source.

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

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Version Information
.NET Framework and NET Compact Framework
Supported in 3.5
.NET Framework
Supported in 3.0
.NET Compact Framework and .Net Framework
Supported in 2.0

Share via