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 SqlCeDataAdapter
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 SqlCeDataAdapter

Représente un ensemble de commandes de données et une connexion de base de données utilisés pour remplir DataSet et mettre à jour la source de données.

System..::.Object
  System..::.MarshalByRefObject
    System.ComponentModel..::.Component
      System.Data.Common..::.DataAdapter
        System.Data.Common..::.DbDataAdapter
          System.Data.SqlServerCe..::.SqlCeDataAdapter

Espace de noms :  System.Data.SqlServerCe
Assembly :  System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)
Visual Basic (Déclaration)
Public NotInheritable Class SqlCeDataAdapter _
    Inherits DbDataAdapter _
    Implements ICloneable
Visual Basic (Utilisation)
Dim instance As SqlCeDataAdapter
C#
public sealed class SqlCeDataAdapter : DbDataAdapter, 
    ICloneable
Visual C++
public ref class SqlCeDataAdapter sealed : public DbDataAdapter, 
    ICloneable
F#
[<SealedAttribute>]
type SqlCeDataAdapter =  
    class
        inherit DbDataAdapter
        interface ICloneable
    end
JScript
public final class SqlCeDataAdapter extends DbDataAdapter implements ICloneable

Le type SqlCeDataAdapter expose les membres suivants.

  NomDescription
Méthode publiqueSqlCeDataAdapter()()()Initialise une nouvelle instance de la classe SqlCeDataAdapter.
Méthode publiqueSqlCeDataAdapter(SqlCeCommand)Initialise une nouvelle instance de la classe SqlCeDataAdapter avec le SqlCeCommand spécifié en tant que propriété SelectCommand.
Méthode publiqueSqlCeDataAdapter(String, SqlCeConnection)Initialise une nouvelle instance de la classe SqlCeDataAdapter avec SelectCommand et un objet SqlCeConnection.
Méthode publiqueSqlCeDataAdapter(String, String)Initialise une nouvelle instance de la classe SqlCeDataAdapter avec SelectCommand et une chaîne de connexion.
Haut de la page
  NomDescription
Propriété publiqueAcceptChangesDuringFill (hérité de DataAdapter)
Propriété publiqueAcceptChangesDuringUpdate (hérité de DataAdapter)
Propriété protégéeCanRaiseEvents (hérité de Component)
Propriété publiqueContainer (hérité de Component)
Propriété publiqueContinueUpdateOnError (hérité de DataAdapter)
Propriété publiqueDeleteCommandObtient ou définit une instruction SQL permettant de supprimer les enregistrements du groupe de données.
Propriété protégéeDesignMode (hérité de Component)
Propriété protégéeEvents (hérité de Component)
Propriété protégéeFillCommandBehavior (hérité de DbDataAdapter)
Propriété publiqueFillLoadOption (hérité de DataAdapter)
Propriété publiqueInsertCommandObtient ou définit une instruction SQL utilisée pour insérer de nouveaux enregistrements dans la source de données.
Propriété publiqueMissingMappingAction (hérité de DataAdapter)
Propriété publiqueMissingSchemaAction (hérité de DataAdapter)
Propriété publiqueReturnProviderSpecificTypes (hérité de DataAdapter)
Propriété publiqueSelectCommandObtient ou définit une instruction SQL utilisée pour sélectionner des enregistrements dans la source de données.
Propriété publiqueSite (hérité de Component)
Propriété publiqueTableMappings (hérité de DataAdapter)
Propriété publiqueUpdateBatchSize (hérité de DbDataAdapter)
Propriété publiqueUpdateCommandObtient ou définit une instruction SQL utilisée pour mettre à jour les enregistrements dans la source de données.
Haut de la page
  NomDescription
Méthode protégéeAddToBatch (hérité de DbDataAdapter)
Méthode protégéeClearBatch (hérité de DbDataAdapter)
Méthode protégéeCloneInternals Obsolète. (hérité de DataAdapter)
Méthode publiqueCreateObjRef (hérité de MarshalByRefObject)
Méthode protégéeCreateRowUpdatedEvent (hérité de DbDataAdapter)
Méthode protégéeCreateRowUpdatingEvent (hérité de DbDataAdapter)
Méthode protégéeCreateTableMappings (hérité de DataAdapter)
Méthode publiqueDispose()()()Supprime l'instance actuelle.
Méthode protégéeDispose(Boolean) (hérité de DbDataAdapter)
Méthode publiqueEquals (hérité de Object)
Méthode protégéeExecuteBatch (hérité de DbDataAdapter)
Méthode publiqueFill(DataSet) (hérité de DbDataAdapter)
Méthode publiqueFill(DataTable) (hérité de DbDataAdapter)
Méthode publiqueFill(DataSet, String) (hérité de DbDataAdapter)
Méthode protégéeFill(DataTable, IDataReader) (hérité de DataAdapter)
Méthode publiqueFill(Int32, Int32, array<DataTable>[]()[]) (hérité de DbDataAdapter)
Méthode protégéeFill(DataTable, IDbCommand, CommandBehavior) (hérité de DbDataAdapter)
Méthode publiqueFill(DataSet, Int32, Int32, String) (hérité de DbDataAdapter)
Méthode protégéeFill(array<DataTable>[]()[], IDataReader, Int32, Int32) (hérité de DataAdapter)
Méthode protégéeFill(array<DataTable>[]()[], Int32, Int32, IDbCommand, CommandBehavior) (hérité de DbDataAdapter)
Méthode protégéeFill(DataSet, String, IDataReader, Int32, Int32) (hérité de DataAdapter)
Méthode protégéeFill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior) (hérité de DbDataAdapter)
Méthode publiqueFillSchema(DataTable, SchemaType) (hérité de DbDataAdapter)
Méthode publiqueFillSchema(DataSet, SchemaType) (hérité de DbDataAdapter)
Méthode publiqueFillSchema(DataSet, SchemaType, String) (hérité de DbDataAdapter)
Méthode protégéeFillSchema(DataTable, SchemaType, IDataReader) (hérité de DataAdapter)
Méthode protégéeFillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior) (hérité de DbDataAdapter)
Méthode protégéeFillSchema(DataSet, SchemaType, String, IDataReader) (hérité de DataAdapter)
Méthode protégéeFillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior) (hérité de DbDataAdapter)
Méthode protégéeFinalize (hérité de Component)
Méthode protégéeGetBatchedParameter (hérité de DbDataAdapter)
Méthode protégéeGetBatchedRecordsAffected (hérité de DbDataAdapter)
Méthode publiqueGetFillParameters (hérité de DbDataAdapter)
Méthode publiqueGetHashCode (hérité de Object)
Méthode publiqueGetLifetimeService (hérité de MarshalByRefObject)
Méthode protégéeGetService (hérité de Component)
Méthode publiqueGetType (hérité de Object)
Méthode protégéeHasTableMappings (hérité de DataAdapter)
Méthode protégéeInitializeBatching (hérité de DbDataAdapter)
Méthode publiqueInitializeLifetimeService (hérité de MarshalByRefObject)
Méthode protégéeMemberwiseClone()()() (hérité de Object)
Méthode protégéeMemberwiseClone(Boolean) (hérité de MarshalByRefObject)
Méthode protégéeOnFillError (hérité de DataAdapter)
Méthode protégéeOnRowUpdated (hérité de DbDataAdapter)
Méthode protégéeOnRowUpdating (hérité de DbDataAdapter)
Méthode publiqueResetFillLoadOption (hérité de DataAdapter)
Méthode publiqueShouldSerializeAcceptChangesDuringFill (hérité de DataAdapter)
Méthode publiqueShouldSerializeFillLoadOption (hérité de DataAdapter)
Méthode protégéeShouldSerializeTableMappings (hérité de DataAdapter)
Méthode protégéeTerminateBatching (hérité de DbDataAdapter)
Méthode publiqueToString (hérité de Component)
Méthode publiqueUpdate(DataSet) (hérité de DbDataAdapter)
Méthode publiqueUpdate(array<DataRow>[]()[]) (hérité de DbDataAdapter)
Méthode publiqueUpdate(DataTable) (hérité de DbDataAdapter)
Méthode publiqueUpdate(DataSet, String) (hérité de DbDataAdapter)
Méthode protégéeUpdate(array<DataRow>[]()[], DataTableMapping) (hérité de DbDataAdapter)
Haut de la page
  NomDescription
Événement publicDisposed (hérité de Component)
Événement publicFillError (hérité de DataAdapter)
Événement publicRowUpdatedSe produit lors d'un appel à Update après l'exécution d'une commande de mise à jour sur la source de données. La tentative de mise à jour provoque le déclenchement de l'événement.
Événement publicRowUpdatingSe produit lors d'un appel à Update avant l'exécution d'une commande de mise à jour sur la source de données. La tentative de mise à jour provoque le déclenchement de l'événement.
Haut de la page

SqlCeDataAdapter joue le rôle de pont entre DataSet et la source de données. Il est utilisé pour récupérer des données de la source de données et y enregistrer des données. SqlCeDataAdapter fournit ce pont en utilisant Fill pour charger les données à partir de la source de données dans DataSet et en utilisant Update pour renvoyer à la source de données les modifications apportées à DataSet.

Lorsque SqlCeDataAdapter remplit DataSet, il crée les tables et colonnes nécessaires pour les données retournées si elles n'existent pas encore. Cependant, les informations de clé primaire ne sont pas incluses dans le schéma créé implicitement, à moins que la valeur AddWithKey soit affectée à la propriété MissingSchemaAction. Vous pouvez également laisser SqlCeDataAdapter créer le schéma de DataSet, comprenant les informations de clé primaire, avant de le remplir avec les données à l'aide de FillSchema.

SqlCeDataAdapter comporte les propriétés SelectCommand, InsertCommand, DeleteCommand, UpdateCommand et TableMappings afin de faciliter le chargement et la mise à jour des données.

Lorsque vous créez une instance de SqlCeDataAdapter, les valeurs initiales sont affectées aux propriétés. Pour obtenir la liste de ces valeurs, consultez le constructeur SqlCeDataAdapter.

L'exemple suivant utilise SqlCeCommand, SqlCeDataAdapter et SqlCeConnection pour sélectionner des enregistrements à partir d'une source de données et remplir DataSet avec les lignes sélectionnées. Le DataSet rempli est ensuite retourné. Pour effectuer cette opération, un DataSet initialisé, une chaîne de connexion et une chaîne de requête qui est une instruction SQL SELECT sont passés à la méthode.

Visual Basic
Try
    Dim strDataSource As String
    strDataSource = "" & _
        "Data Source = C:\Program Files\" & _
        "Microsoft SQL Server Compact Edition\v3.5\Samples\" & _
        "Northwind.sdf"
    Dim conn As New SqlCeConnection
    conn.ConnectionString = strDataSource & ";Password='<password>'"

    Dim selectCmd As SqlCeCommand = conn.CreateCommand
    selectCmd.CommandText = "SELECT * FROM Employees"

    Dim adp As New SqlCeDataAdapter(selectCmd)

    Dim ds As New DataSet

    ' Note: Fill will leave the connection in its original state;
    ' In this case, the connection was closed so it will be left closed
    adp.Fill(ds)

    Console.WriteLine(("The SqlCeDataAdapter succesfully filled " & _
                       ds.Tables.Item(0).Rows.Count & " rows in the DataSet!"))
Catch ds As Exception
    Console.WriteLine(ds.Message)
Finally
    Console.WriteLine(vbNewLine & vbNewLine & vbNewLine & _
                      "Press any key to continue...")
    Console.ReadKey()
End Try
C#
try
{
    string strDataSource =
        @"Data Source = C:\Program Files\" +
        @"Microsoft SQL Server Compact Edition\v3.5\Samples\" +
        @"Northwind.sdf";
    SqlCeConnection conn = new SqlCeConnection();
    conn.ConnectionString = strDataSource + ";Password='<password>'";

    SqlCeCommand selectCmd = conn.CreateCommand();
    selectCmd.CommandText = "SELECT * FROM Employees";

    SqlCeDataAdapter adp = new SqlCeDataAdapter(selectCmd);

    DataSet ds = new DataSet();

    // Note: Fill will leave the connection in its original state;
    // In this case, the connection was closed so it will be left closed
    //
    adp.Fill(ds);

    Console.WriteLine("The SqlCeDataAdapter succesfully filled " +
        ds.Tables[0].Rows.Count + " rows in the DataSet!");
}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
}
finally
{
    Console.WriteLine("\n\n\nPress any key to continue...");
    Console.ReadKey();
}
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