SqlCeDataReader Class
Fournit un moyen de lire un flux de lignes de données avant uniquement à partir d'une source de données. Cette classe ne peut pas être héritée.
Espace de noms: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (dans system.data.sqlserverce.dll)
Syntaxe
'Déclaration
<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
Remarques
Pour créer SqlCeDataReader, vous devez appeler la méthode ExecuteReader de l'objet SqlCeCommand, au lieu de recourir directement à un constructeur.
Lorsque SqlCeDataReader est utilisé, le SqlCeConnection associé est occupé à servir SqlCeDataReader. Dans cet état, vous pouvez créer plusieurs lecteurs dans la même connexion.
Les modifications apportées à un jeu de résultats par un autre processus ou thread pendant la lecture des données peuvent être visibles par l'utilisateur de SqlCeDataReader ; cependant, le comportement effectif dépend du moment où ces modifications se produisent.
IsClosed et RecordsAffected sont les seules propriétés pouvant être appelées après la fermeture de SqlCeDataReader. Bien que vous puissiez accéder à la propriété RecordsAffected à tout moment si SqlCeDataReader existe, appelez toujours Close avant de retourner la valeur de RecordsAffected afin de garantir une valeur de retour précise.
Hiérarchie d'héritage
System.Object
System.MarshalByRefObject
System.Data.Common.DbDataReader
System.Data.SqlServerCe.SqlCeDataReader
System.Data.SqlServerCe.SqlCeResultSet
Exemple
L'exemple suivant crée un SqlCeConnection, un SqlCeCommand et SqlCeDataReader. L'exemple lit les données et les écrit dans la console, puis ferme SqlCeDataReader et 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();
}
Sécurité des threads
Tout membre statique public (Partagé dans Microsoft Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme sûrs.
Plateformes
Plateformes de développement
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
Informations sur la version
.NET Framework et NET Compact Framework
Pris en charge dans 3.5
.NET Framework
Pris en charge dans 3.0
.NET Compact Framework et .Net Framework
Pris en charge dans 2.0