Version imprimable       Envoyer     
Cliquez pour évaluer et commenter
TechNet
Bibliothèque TechNet
SQL Server
SQL Server Compact 4.0
Référence technique de SQ...
Classe SqlCeDataReader
Réduire tout/Développer tout Réduire tout
Cette page est spécifique à
Microsoft Visual Studio 2010/.NET Framework 4

D'autres versions sont également disponibles pour :
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)
Visual Basic (Déclaration)
Public Class SqlCeDataReader _
    Inherits DbDataReader
Visual Basic (Utilisation)
Dim instance As SqlCeDataReader
C#
public class SqlCeDataReader : DbDataReader
Visual C++
public ref class SqlCeDataReader : public DbDataReader
F#
type SqlCeDataReader =  
    class
        inherit DbDataReader
    end
JScript
public class SqlCeDataReader extends DbDataReader

Le type SqlCeDataReader expose les membres suivants.

  NomDescription
Propriété publiqueDepthObtient une valeur indiquant la profondeur d'imbrication de la ligne actuelle. (remplace DbDataReader..::.Depth.)
Propriété publiqueFieldCountObtient le nombre de colonnes de la clause SELECT de la requête. (remplace DbDataReader..::.FieldCount.)
Propriété publiqueHasRowsObtient une valeur qui indique si SqlCeDataReader contient une ou plusieurs lignes. (remplace DbDataReader..::.HasRows.)
Propriété publiqueHiddenFieldCountInfrastructure.
Propriété publiqueIsClosedIndique si le lecteur de données est fermé. (remplace DbDataReader..::.IsClosed.)
Propriété publiqueItem[([(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é publiqueItem[([(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é publiqueRecordsAffectedObtient 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é publiqueVisibleFieldCount (hérité de DbDataReader)
Haut de la page
  NomDescription
Méthode publiqueCloseFerme l'objet SqlCeDataReader. (remplace DbDataReader..::.Close()()().)
Méthode publiqueCreateObjRef (hérité de MarshalByRefObject)
Méthode publiqueDispose()()()Infrastructure. Libère les ressources utilisées par cet SqlCeDataReader.
Méthode protégéeDispose(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 publiqueEquals (hérité de Object)
Méthode protégéeFinalizeLibè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 publiqueGetBooleanObtient la valeur de la colonne spécifiée comme Boolean. (remplace DbDataReader..::.GetBoolean(Int32).)
Méthode publiqueGetByteObtient la valeur de la colonne spécifiée sous la forme d'un octet. (remplace DbDataReader..::.GetByte(Int32).)
Méthode publiqueGetBytesLit 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 publiqueGetCharNon pris en charge dans le fournisseur de données .NET Compact Framework pour SQL Server Compact. (remplace DbDataReader..::.GetChar(Int32).)
Méthode publiqueGetCharsLit 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 publiqueGetData (hérité de DbDataReader)
Méthode publiqueGetDataTypeNameObtient le nom du type de données source. (remplace DbDataReader..::.GetDataTypeName(Int32).)
Méthode publiqueGetDateTimeObtient la valeur de la colonne spécifiée sous la forme d'un objet DateTime. (remplace DbDataReader..::.GetDateTime(Int32).)
Méthode protégéeGetDbDataReader (hérité de DbDataReader)
Méthode publiqueGetDecimalObtient la valeur de la colonne spécifiée sous la forme d'un objet Decimal. (remplace DbDataReader..::.GetDecimal(Int32).)
Méthode publiqueGetDoubleObtient 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 publiqueGetEnumeratorInfrastructure. (remplace DbDataReader..::.GetEnumerator()()().)
Méthode publiqueGetFieldTypeObtient le Type qui correspond au type de données de l'objet. (remplace DbDataReader..::.GetFieldType(Int32).)
Méthode publiqueGetFloatObtient 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 publiqueGetGuidObtient 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 publiqueGetHashCode (hérité de Object)
Méthode publiqueGetInt16Obtient la valeur de la colonne spécifiée sous la forme d'un entier signé 16 bits. (remplace DbDataReader..::.GetInt16(Int32).)
Méthode publiqueGetInt32Obtient la valeur de la colonne spécifiée sous la forme d'un entier signé 32 bits. (remplace DbDataReader..::.GetInt32(Int32).)
Méthode publiqueGetInt64Obtient la valeur de la colonne spécifiée sous la forme d'un entier signé 64 bits. (remplace DbDataReader..::.GetInt64(Int32).)
Méthode publiqueGetLifetimeService (hérité de MarshalByRefObject)
Méthode publiqueGetNameObtient le nom de la colonne spécifiée. (remplace DbDataReader..::.GetName(Int32).)
Méthode publiqueGetOrdinalObtient le numéro de la colonne, en fonction du nom de la colonne. (remplace DbDataReader..::.GetOrdinal(String).)
Méthode publiqueGetProviderSpecificFieldTypeObtient un Object qui est une représentation du type de champ spécifique au fournisseur sous-jacent. (remplace DbDataReader..::.GetProviderSpecificFieldType(Int32).)
Méthode publiqueGetProviderSpecificValue (hérité de DbDataReader)
Méthode publiqueGetProviderSpecificValues (hérité de DbDataReader)
Méthode publiqueGetSchemaTableRetourne DataTable qui décrit les métadonnées de la colonne de SqlCeDataReader. (remplace DbDataReader..::.GetSchemaTable()()().)
Méthode publiqueGetSqlBinaryObtient la valeur de la colonne spécifiée en tant que SqlBinary.
Méthode publiqueGetSqlBooleanObtient la valeur de la colonne spécifiée en tant que SqlBoolean.
Méthode publiqueGetSqlByteObtient la valeur de la colonne spécifiée en tant que SqlByte.
Méthode publiqueGetSqlDateTimeObtient la valeur de la colonne spécifiée en tant que SqlDateTime.
Méthode publiqueGetSqlDecimalObtient la valeur de la colonne spécifiée en tant que SqlDecimal.
Méthode publiqueGetSqlDoubleObtient la valeur de la colonne spécifiée en tant que SqlDouble.
Méthode publiqueGetSqlGuidObtient la valeur de la colonne spécifiée en tant que SqlGuid.
Méthode publiqueGetSqlInt16Obtient la valeur de la colonne spécifiée en tant que SqlInt16.
Méthode publiqueGetSqlInt32Obtient la valeur de la colonne spécifiée en tant que SqlInt32.
Méthode publiqueGetSqlInt64Obtient la valeur de la colonne spécifiée en tant que SqlInt64.
Méthode publiqueGetSqlMoneyObtient la valeur de la colonne spécifiée en tant que SqlMoney.
Méthode publiqueGetSqlSingleObtient la valeur de la colonne spécifiée en tant que SqlSingle.
Méthode publiqueGetSqlStringObtient la valeur de la colonne spécifiée en tant que SqlString.
Méthode publiqueGetStringObtient la valeur de la colonne spécifiée sous la forme d'une chaîne. (remplace DbDataReader..::.GetString(Int32).)
Méthode publiqueGetType (hérité de Object)
Méthode publiqueGetValueObtient la valeur de la colonne à l'ordinal spécifié dans son format natif. (remplace DbDataReader..::.GetValue(Int32).)
Méthode publiqueGetValuesObtient toutes les colonnes d'attributs figurant dans la ligne actuelle. (remplace DbDataReader..::.GetValues(array<Object>[]()[]).)
Méthode publiqueInitializeLifetimeService (hérité de MarshalByRefObject)
Méthode protégéeIsCommandBehaviorDétermine si le CommandBehavior spécifié correspond à cet SqlCeDataReader.
Méthode publiqueIsDBNullObtient une valeur indiquant si la colonne contient des valeurs inexistantes ou manquantes. (remplace DbDataReader..::.IsDBNull(Int32).)
Méthode protégéeMemberwiseClone()()() (hérité de Object)
Méthode protégéeMemberwiseClone(Boolean) (hérité de MarshalByRefObject)
Méthode publiqueNextResultNon pris en charge dans le fournisseur de données .NET Compact Framework pour SQL Server Compact. (remplace DbDataReader..::.NextResult()()().)
Méthode protégéeOnMoveInfrastructure.
Méthode publiqueReadAvance SqlCeDataReader jusqu'à l'enregistrement suivant. (remplace DbDataReader..::.Read()()().)
Méthode publiqueSeekPlace SqlCeDataReader sur l'enregistrement ayant des valeurs indexées qui correspondent aux paramètres spécifiés.
Méthode publiqueToString (hérité de Object)
Haut de la page
  NomDescription
Implémentation d'interface expliciteMéthode privéeIDataRecord..::.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.

Visual Basic
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
C#
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.
© 2012 Microsoft. Tous droits réservés. Conditions d'utilisation | Marques | Confidentialité
Page view tracker