Classe SqlCeDataReader

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.

System.Object
  System.MarshalByRefObject
    System.Data.Common.DbDataReader
      System.Data.SqlServerCe.SqlCeDataReader
        System.Data.SqlServerCe.SqlCeResultSet

Espace de noms :  System.Data.SqlServerCe
Assembly :  System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

'Déclaration
Public Class SqlCeDataReader _
    Inherits DbDataReader
'Utilisation
Dim instance As SqlCeDataReader

public class SqlCeDataReader : DbDataReader

public ref class SqlCeDataReader : public DbDataReader

type SqlCeDataReader =  
    class
        inherit DbDataReader
    end

public class SqlCeDataReader extends DbDataReader

Le type SqlCeDataReader expose les membres suivants.

	Nom	Description
	Depth	Obtient une valeur indiquant la profondeur d'imbrication de la ligne actuelle. (remplace DbDataReader.Depth.)
	FieldCount	Obtient le nombre de colonnes de la clause SELECT de la requête. (remplace DbDataReader.FieldCount.)
	HasRows	Obtient une valeur qui indique si SqlCeDataReader contient une ou plusieurs lignes. (remplace DbDataReader.HasRows.)
	HiddenFieldCount	Infrastructure.
	IsClosed	Indique si le lecteur de données est fermé. (remplace DbDataReader.IsClosed.)
	Item[Int32]	Obtient la valeur de la colonne spécifiée dans son format natif en fonction du numéro de la colonne. (remplace DbDataReader.Item[Int32].)
	Item[String]	Obtient la valeur de la colonne spécifiée dans son format natif en fonction du nom de la colonne. (remplace DbDataReader.Item[String].)
	RecordsAffected	Obtient le nombre de lignes modifiées, insérées ou supprimées par l'exécution de l'instruction SQL. (remplace DbDataReader.RecordsAffected.)
	VisibleFieldCount	(hérité de DbDataReader)

Haut de la page

	Nom	Description
	Close	Ferme l'objet SqlCeDataReader. (remplace DbDataReader.Close().)
	CreateObjRef	(hérité de MarshalByRefObject)
	Dispose()	Infrastructure. Libère les ressources utilisées par cet SqlCeDataReader.
	Dispose(Boolean)	Libère les ressources non managées utilisées par cet SqlCeDataReader et libère éventuellement aussi les ressources managées. (remplace DbDataReader.Dispose(Boolean).)
	Equals	(hérité de Object)
	Finalize	Libère les ressources non managées et exécute d'autres opérations de nettoyage avant la récupération de SqlCeDataReader par le garbage collection. (remplace Object.Finalize().)
	GetBoolean	Obtient la valeur de la colonne spécifiée comme Boolean. (remplace DbDataReader.GetBoolean(Int32).)
	GetByte	Obtient la valeur de la colonne spécifiée sous la forme d'un octet. (remplace DbDataReader.GetByte(Int32).)
	GetBytes	Lit un flux d'octets à partir de l'offset de colonne spécifié dans la mémoire tampon sous la forme d'un tableau commençant à l'offset de mémoire tampon donné. (remplace DbDataReader.GetBytes(Int32, Int64, array<Byte[], Int32, Int32).)
	GetChar	Non pris en charge dans le fournisseur de données .NET Compact Framework pour SQL Server Compact. (remplace DbDataReader.GetChar(Int32).)
	GetChars	Lit un flux de caractères à partir de l'offset de colonne spécifié dans la mémoire tampon sous la forme d'un tableau commençant à l'offset de mémoire tampon donné. (remplace DbDataReader.GetChars(Int32, Int64, array<Char[], Int32, Int32).)
	GetData	(hérité de DbDataReader)
	GetDataTypeName	Obtient le nom du type de données source. (remplace DbDataReader.GetDataTypeName(Int32).)
	GetDateTime	Obtient la valeur de la colonne spécifiée sous la forme d'un objet DateTime. (remplace DbDataReader.GetDateTime(Int32).)
	GetDbDataReader	(hérité de DbDataReader)
	GetDecimal	Obtient la valeur de la colonne spécifiée sous la forme d'un objet Decimal. (remplace DbDataReader.GetDecimal(Int32).)
	GetDouble	Obtient la valeur de la colonne spécifiée sous la forme d'un nombre à virgule flottante double précision. (remplace DbDataReader.GetDouble(Int32).)
	GetEnumerator	Infrastructure. (remplace DbDataReader.GetEnumerator().)
	GetFieldType	Obtient le Type qui correspond au type de données de l'objet. (remplace DbDataReader.GetFieldType(Int32).)
	GetFloat	Obtient la valeur de la colonne spécifiée sous la forme d'un nombre à virgule flottante simple précision. (remplace DbDataReader.GetFloat(Int32).)
	GetGuid	Obtient la valeur de la colonne spécifiée sous la forme d'un identificateur global unique (GUID, Globally-Unique IDentifier). (remplace DbDataReader.GetGuid(Int32).)
	GetHashCode	(hérité de Object)
	GetInt16	Obtient la valeur de la colonne spécifiée sous la forme d'un entier signé 16 bits. (remplace DbDataReader.GetInt16(Int32).)
	GetInt32	Obtient la valeur de la colonne spécifiée sous la forme d'un entier signé 32 bits. (remplace DbDataReader.GetInt32(Int32).)
	GetInt64	Obtient la valeur de la colonne spécifiée sous la forme d'un entier signé 64 bits. (remplace DbDataReader.GetInt64(Int32).)
	GetLifetimeService	(hérité de MarshalByRefObject)
	GetName	Obtient le nom de la colonne spécifiée. (remplace DbDataReader.GetName(Int32).)
	GetOrdinal	Obtient le numéro de la colonne, en fonction du nom de la colonne. (remplace DbDataReader.GetOrdinal(String).)
	GetProviderSpecificFieldType	Obtient un Object qui est une représentation du type de champ spécifique au fournisseur sous-jacent. (remplace DbDataReader.GetProviderSpecificFieldType(Int32).)
	GetProviderSpecificValue	(hérité de DbDataReader)
	GetProviderSpecificValues	(hérité de DbDataReader)
	GetSchemaTable	Retourne DataTable qui décrit les métadonnées de la colonne de SqlCeDataReader. (remplace DbDataReader.GetSchemaTable().)
	GetSqlBinary	Obtient la valeur de la colonne spécifiée en tant que SqlBinary.
	GetSqlBoolean	Obtient la valeur de la colonne spécifiée en tant que SqlBoolean.
	GetSqlByte	Obtient la valeur de la colonne spécifiée en tant que SqlByte.
	GetSqlDateTime	Obtient la valeur de la colonne spécifiée en tant que SqlDateTime.
	GetSqlDecimal	Obtient la valeur de la colonne spécifiée en tant que SqlDecimal.
	GetSqlDouble	Obtient la valeur de la colonne spécifiée en tant que SqlDouble.
	GetSqlGuid	Obtient la valeur de la colonne spécifiée en tant que SqlGuid.
	GetSqlInt16	Obtient la valeur de la colonne spécifiée en tant que SqlInt16.
	GetSqlInt32	Obtient la valeur de la colonne spécifiée en tant que SqlInt32.
	GetSqlInt64	Obtient la valeur de la colonne spécifiée en tant que SqlInt64.
	GetSqlMoney	Obtient la valeur de la colonne spécifiée en tant que SqlMoney.
	GetSqlSingle	Obtient la valeur de la colonne spécifiée en tant que SqlSingle.
	GetSqlString	Obtient la valeur de la colonne spécifiée en tant que SqlString.
	GetString	Obtient la valeur de la colonne spécifiée sous la forme d'une chaîne. (remplace DbDataReader.GetString(Int32).)
	GetType	(hérité de Object)
	GetValue	Obtient la valeur de la colonne à l'ordinal spécifié dans son format natif. (remplace DbDataReader.GetValue(Int32).)
	GetValues	Obtient toutes les colonnes d'attributs figurant dans la ligne actuelle. (remplace DbDataReader.GetValues(array<Object[]).)
	InitializeLifetimeService	(hérité de MarshalByRefObject)
	IsCommandBehavior	Détermine si le CommandBehavior spécifié correspond à cet SqlCeDataReader.
	IsDBNull	Obtient une valeur indiquant si la colonne contient des valeurs inexistantes ou manquantes. (remplace DbDataReader.IsDBNull(Int32).)
	MemberwiseClone()	(hérité de Object)
	MemberwiseClone(Boolean)	(hérité de MarshalByRefObject)
	NextResult	Non pris en charge dans le fournisseur de données .NET Compact Framework pour SQL Server Compact. (remplace DbDataReader.NextResult().)
	OnMove	Infrastructure.
	Read	Avance SqlCeDataReader jusqu'à l'enregistrement suivant. (remplace DbDataReader.Read().)
	Seek	Place SqlCeDataReader sur l'enregistrement ayant des valeurs indexées qui correspondent aux paramètres spécifiés.
	ToString	(hérité de Object)

Haut de la page

	Nom	Description
	IDataRecord.GetData	(hérité de DbDataReader)

Haut de la page

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.

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

Tout membre statique public (Shared en Microsoft Visual Basic) de ce type est thread-safe. Tous les membres de l'instance ne sont pas garantis comme sûrs.

Espace de noms System.Data.SqlServerCe