Classe SqlCeDataReader

  • Article

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.

Hiérarchie d'héritage

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)

Syntaxe

'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.

Propriétés

  Nom Description
Propriété publique Depth Obtient une valeur indiquant la profondeur d'imbrication de la ligne actuelle. (remplace DbDataReader.Depth.)
Propriété publique FieldCount Obtient le nombre de colonnes de la clause SELECT de la requête. (remplace DbDataReader.FieldCount.)
Propriété publique HasRows Obtient une valeur qui indique si SqlCeDataReader contient une ou plusieurs lignes. (remplace DbDataReader.HasRows.)
Propriété publique HiddenFieldCount Infrastructure.
Propriété publique IsClosed Indique si le lecteur de données est fermé. (remplace DbDataReader.IsClosed.)
Propriété publique 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].)
Propriété publique 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].)
Propriété publique 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.)
Propriété publique VisibleFieldCount (hérité de DbDataReader)

Haut de la page

Méthodes

  Nom Description
Méthode publique Close Ferme l'objet SqlCeDataReader. (remplace DbDataReader.Close().)
Méthode publique CreateObjRef (hérité de MarshalByRefObject)
Méthode publique Dispose() Infrastructure. Libère les ressources utilisées par cet SqlCeDataReader.
Méthode protégée 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).)
Méthode publique Equals (hérité de Object)
Méthode protégée 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().)
Méthode publique GetBoolean Obtient la valeur de la colonne spécifiée comme Boolean. (remplace DbDataReader.GetBoolean(Int32).)
Méthode publique GetByte Obtient la valeur de la colonne spécifiée sous la forme d'un octet. (remplace DbDataReader.GetByte(Int32).)
Méthode publique 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).)
Méthode publique GetChar Non pris en charge dans le fournisseur de données .NET Compact Framework pour SQL Server Compact. (remplace DbDataReader.GetChar(Int32).)
Méthode publique 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).)
Méthode publique GetData (hérité de DbDataReader)
Méthode publique GetDataTypeName Obtient le nom du type de données source. (remplace DbDataReader.GetDataTypeName(Int32).)
Méthode publique GetDateTime Obtient la valeur de la colonne spécifiée sous la forme d'un objet DateTime. (remplace DbDataReader.GetDateTime(Int32).)
Méthode protégée GetDbDataReader (hérité de DbDataReader)
Méthode publique GetDecimal Obtient la valeur de la colonne spécifiée sous la forme d'un objet Decimal. (remplace DbDataReader.GetDecimal(Int32).)
Méthode publique 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).)
Méthode publique GetEnumerator Infrastructure. (remplace DbDataReader.GetEnumerator().)
Méthode publique GetFieldType Obtient le Type qui correspond au type de données de l'objet. (remplace DbDataReader.GetFieldType(Int32).)
Méthode publique 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).)
Méthode publique 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).)
Méthode publique GetHashCode (hérité de Object)
Méthode publique GetInt16 Obtient la valeur de la colonne spécifiée sous la forme d'un entier signé 16 bits. (remplace DbDataReader.GetInt16(Int32).)
Méthode publique GetInt32 Obtient la valeur de la colonne spécifiée sous la forme d'un entier signé 32 bits. (remplace DbDataReader.GetInt32(Int32).)
Méthode publique GetInt64 Obtient la valeur de la colonne spécifiée sous la forme d'un entier signé 64 bits. (remplace DbDataReader.GetInt64(Int32).)
Méthode publique GetLifetimeService (hérité de MarshalByRefObject)
Méthode publique GetName Obtient le nom de la colonne spécifiée. (remplace DbDataReader.GetName(Int32).)
Méthode publique GetOrdinal Obtient le numéro de la colonne, en fonction du nom de la colonne. (remplace DbDataReader.GetOrdinal(String).)
Méthode publique GetProviderSpecificFieldType Obtient un Object qui est une représentation du type de champ spécifique au fournisseur sous-jacent. (remplace DbDataReader.GetProviderSpecificFieldType(Int32).)
Méthode publique GetProviderSpecificValue (hérité de DbDataReader)
Méthode publique GetProviderSpecificValues (hérité de DbDataReader)
Méthode publique GetSchemaTable Retourne DataTable qui décrit les métadonnées de la colonne de SqlCeDataReader. (remplace DbDataReader.GetSchemaTable().)
Méthode publique GetSqlBinary Obtient la valeur de la colonne spécifiée en tant que SqlBinary.
Méthode publique GetSqlBoolean Obtient la valeur de la colonne spécifiée en tant que SqlBoolean.
Méthode publique GetSqlByte Obtient la valeur de la colonne spécifiée en tant que SqlByte.
Méthode publique GetSqlDateTime Obtient la valeur de la colonne spécifiée en tant que SqlDateTime.
Méthode publique GetSqlDecimal Obtient la valeur de la colonne spécifiée en tant que SqlDecimal.
Méthode publique GetSqlDouble Obtient la valeur de la colonne spécifiée en tant que SqlDouble.
Méthode publique GetSqlGuid Obtient la valeur de la colonne spécifiée en tant que SqlGuid.
Méthode publique GetSqlInt16 Obtient la valeur de la colonne spécifiée en tant que SqlInt16.
Méthode publique GetSqlInt32 Obtient la valeur de la colonne spécifiée en tant que SqlInt32.
Méthode publique GetSqlInt64 Obtient la valeur de la colonne spécifiée en tant que SqlInt64.
Méthode publique GetSqlMoney Obtient la valeur de la colonne spécifiée en tant que SqlMoney.
Méthode publique GetSqlSingle Obtient la valeur de la colonne spécifiée en tant que SqlSingle.
Méthode publique GetSqlString Obtient la valeur de la colonne spécifiée en tant que SqlString.
Méthode publique GetString Obtient la valeur de la colonne spécifiée sous la forme d'une chaîne. (remplace DbDataReader.GetString(Int32).)
Méthode publique GetType (hérité de Object)
Méthode publique GetValue Obtient la valeur de la colonne à l'ordinal spécifié dans son format natif. (remplace DbDataReader.GetValue(Int32).)
Méthode publique GetValues Obtient toutes les colonnes d'attributs figurant dans la ligne actuelle. (remplace DbDataReader.GetValues(array<Object[]).)
Méthode publique InitializeLifetimeService (hérité de MarshalByRefObject)
Méthode protégée IsCommandBehavior Détermine si le CommandBehavior spécifié correspond à cet SqlCeDataReader.
Méthode publique IsDBNull Obtient une valeur indiquant si la colonne contient des valeurs inexistantes ou manquantes. (remplace DbDataReader.IsDBNull(Int32).)
Méthode protégée MemberwiseClone() (hérité de Object)
Méthode protégée MemberwiseClone(Boolean) (hérité de MarshalByRefObject)
Méthode publique NextResult Non pris en charge dans le fournisseur de données .NET Compact Framework pour SQL Server Compact. (remplace DbDataReader.NextResult().)
Méthode protégée OnMove Infrastructure.
Méthode publique Read Avance SqlCeDataReader jusqu'à l'enregistrement suivant. (remplace DbDataReader.Read().)
Méthode publique Seek Place SqlCeDataReader sur l'enregistrement ayant des valeurs indexées qui correspondent aux paramètres spécifiés.
Méthode publique ToString (hérité de Object)

Haut de la page

Implémentations d'interfaces explicites

  Nom Description
Implémentation d'interface expliciteMéthode privée IDataRecord.GetData (hérité de DbDataReader)

Haut de la page

Notes

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.

Exemples

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 (Shared en Microsoft Visual Basic) de ce type est thread-safe. Tous les membres de l'instance ne sont pas garantis comme sûrs.

Voir aussi

Référence

Espace de noms System.Data.SqlServerCe