SqlCeDataReader Class
Proporciona el modo de lectura de una secuencia de filas de datos de tipo sólo avance de un origen de datos. No se puede heredar esta clase.
Espacio de nombres: System.Data.SqlServerCe
Ensamblado: System.Data.SqlServerCe (en system.data.sqlserverce.dll)
Sintaxis
'Declaración
<DefaultMemberAttribute("Item")> _
Public Class SqlCeDataReader
Inherits DbDataReader
[DefaultMemberAttribute("Item")]
public class SqlCeDataReader : DbDataReader
[DefaultMemberAttribute(L"Item")]
public ref class SqlCeDataReader : public DbDataReader
/** @attribute DefaultMemberAttribute("Item") */
public class SqlCeDataReader extends DbDataReader
DefaultMemberAttribute("Item")
public class SqlCeDataReader extends DbDataReader
Notas
Para crear un objeto SqlCeDataReader, se debe llamar al método ExecuteReader del objeto SqlCeCommand, en vez de utilizar directamente un constructor.
Mientras se utiliza SqlCeDataReader, la interfaz SqlCeConnection asociada está ocupada atendiendo a SqlCeDataReader. En este estado, pueden crearse varios lectores en la misma conexión.
Los cambios realizados por otro proceso o subproceso en un conjunto de resultados mientras se leen los datos pueden ser visibles para el usuario de SqlCeDataReader; sin embargo, el comportamiento exacto depende del momento en que se producen dichos cambios.
IsClosed y RecordsAffected son las únicas propiedades a las que se puede llamar una vez se ha cerrado el objeto SqlCeDataReader. Aunque se puede obtener acceso a la propiedad RecordsAffected siempre que SqlCeDataReader exista, se debe llamar siempre a Close antes de devolver el valor de RecordsAffected para garantizar que se devuelve un valor preciso.
Jerarquía de herencia
System.Object
System.MarshalByRefObject
System.Data.Common.DbDataReader
System.Data.SqlServerCe.SqlCeDataReader
System.Data.SqlServerCe.SqlCeResultSet
Ejemplo
En el siguiente ejemplo, se crean una conexión SqlCeConnection, un objeto SqlCeCommand y un SqlCeDataReader. En el ejemplo, se leen los datos y se escriben en la consola y, a continuación, se cierran el objeto SqlCeDataReader y la SqlCeConnection.
Dim conn As SqlCeConnection = Nothing
Dim cmd As SqlCeCommand = Nothing
Dim rdr As SqlCeDataReader = Nothing
Try
' Open the connection and create a SQL command
'
conn = New SqlCeConnection("Data Source = AdventureWorks.sdf")
conn.Open()
cmd = New SqlCeCommand("SELECT * FROM DimEmployee", conn)
rdr = cmd.ExecuteReader()
' Iterate through the results
'
While rdr.Read()
Dim employeeID As Integer = rdr.GetInt32(0) ' or: rdr["EmployeeKey"];
Dim lastName As String = rdr.GetString(5) ' or: rdr["FirstName"];
End While
' Always dispose data readers and commands as soon as practicable
'
rdr.Close()
cmd.Dispose()
Finally
' Close the connection when no longer needed
'
conn.Close()
End Try
SqlCeConnection conn = null;
SqlCeCommand cmd = null;
SqlCeDataReader rdr = null;
try
{
// Open the connection and create a SQL command
//
conn = new SqlCeConnection("Data Source = AdventureWorks.sdf");
conn.Open();
cmd = new SqlCeCommand("SELECT * FROM DimEmployee", conn);
rdr = cmd.ExecuteReader();
// Iterate through the results
//
while (rdr.Read())
{
int employeeID = rdr.GetInt32(0); // or: rdr["EmployeeKey"];
string lastName = rdr.GetString(5); // or: rdr["FirstName"];
}
// Always dispose data readers and commands as soon as practicable
//
rdr.Close();
cmd.Dispose();
}
finally
{
// Close the connection when no longer needed
//
conn.Close();
}
Seguridad para subprocesos
Todos los miembros (Compartidos en Microsoft Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.
Plataformas
Plataformas de desarrollo
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
Información de la versión
.NET Framework y NET Compact Framework
Se admite en 3.5
.NET Framework
Se admite en 3.0
.NET Compact Framework y .Net Framework
Se admite en 2.0