SqlCeDataReader Class
Fornece uma maneira de ler um fluxo apenas de encaminhamento de linhas de dados de uma fonte de dados. Esta classe não pode ser herdada.
Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em system.data.sqlserverce.dll)
Sintaxe
'Declaração
<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
Comentários
Para criar um SqlCeDataReader, chame o método ExecuteReader do objeto SqlCeCommand, em vez de usar diretamente um construtor.
Enquanto o SqlCeDataReader está sendo usado, a SqlCeConnection associada está ocupada atendendo o SqlCeDataReader. Neste estado, você pode criar vários leitores na mesma conexão.
As alterações feitas a um conjunto de resultados por outro processo ou thread enquanto os dados são lidos podem ser visíveis para o usuário do SqlCeDataReader; contudo, o comportamento preciso depende do quando ocorrem.
IsClosed e RecordsAffected são as únicas propriedades que você pode chamar depois que o SqlCeDataReader é fechado. Apesar de ser possível acessar propriedade RecordsAffected a qualquer momento enquanto o SqlCeDataReader existir, sempre chame Close antes de retornar o valor de RecordsAffected para assegurar um valor de retorno preciso.
Hierarquia de herança
System.Object
System.MarshalByRefObject
System.Data.Common.DbDataReader
System.Data.SqlServerCe.SqlCeDataReader
System.Data.SqlServerCe.SqlCeResultSet
Exemplo
O exemplo a seguir cria uma SqlCeConnection, um SqlCeCommand e um SqlCeDataReader. O exemplo lê os dados e os grava no console; em seguida, fecha o SqlCeDataReader e a 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();
}
Segurança de thread
Quaisquer membros estáticos públicos (compartilhados no Microsoft Visual Basic) desse tipo são thread safe. Não há garantia de que qualquer membro de instância seja thread safe.
Plataformas
Plataformas de desenvolvimento
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
Informações de versão
.NET Framework e NET Compact Framework
Com suporte no 3.5
.NET Framework
Com suporte no 3.0
.NET Compact Framework e .Net Framework
Com suporte no 2.0