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.
Hiérarchie d'héritage
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)
Syntaxe
'Déclaration
Public NotInheritable Class SqlCeDataAdapter _
Inherits DbDataAdapter _
Implements ICloneable
'Utilisation
Dim instance As SqlCeDataAdapter
public sealed class SqlCeDataAdapter : DbDataAdapter,
ICloneable
public ref class SqlCeDataAdapter sealed : public DbDataAdapter,
ICloneable
[<SealedAttribute>]
type SqlCeDataAdapter =
class
inherit DbDataAdapter
interface ICloneable
end
public final class SqlCeDataAdapter extends DbDataAdapter implements ICloneable
Le type SqlCeDataAdapter expose les membres suivants.
Constructeurs
| Nom | Description | |
|---|---|---|
.gif "Méthode publique") |
SqlCeDataAdapter() | Initialise une nouvelle instance de la classe SqlCeDataAdapter. |
|
SqlCeDataAdapter(SqlCeCommand) | Initialise une nouvelle instance de la classe SqlCeDataAdapter avec le SqlCeCommand spécifié en tant que propriété SelectCommand. |
|
SqlCeDataAdapter(String, SqlCeConnection) | Initialise une nouvelle instance de la classe SqlCeDataAdapter avec SelectCommand et un objet SqlCeConnection. |
|
SqlCeDataAdapter(String, String) | Initialise une nouvelle instance de la classe SqlCeDataAdapter avec SelectCommand et une chaîne de connexion. |
Haut de la page
Propriétés
| Nom | Description | |
|---|---|---|
.gif "Propriété publique") |
AcceptChangesDuringFill | (hérité de DataAdapter) |
|
AcceptChangesDuringUpdate | (hérité de DataAdapter) |
.gif "Propriété protégée") |
CanRaiseEvents | (hérité de Component) |
|
Container | (hérité de Component) |
|
ContinueUpdateOnError | (hérité de DataAdapter) |
|
DeleteCommand | Obtient ou définit une instruction SQL permettant de supprimer les enregistrements du groupe de données. |
|
DesignMode | (hérité de Component) |
|
Events | (hérité de Component) |
|
FillCommandBehavior | (hérité de DbDataAdapter) |
|
FillLoadOption | (hérité de DataAdapter) |
|
InsertCommand | Obtient ou définit une instruction SQL utilisée pour insérer de nouveaux enregistrements dans la source de données. |
|
MissingMappingAction | (hérité de DataAdapter) |
|
MissingSchemaAction | (hérité de DataAdapter) |
|
ReturnProviderSpecificTypes | (hérité de DataAdapter) |
|
SelectCommand | Obtient ou définit une instruction SQL utilisée pour sélectionner des enregistrements dans la source de données. |
|
Site | (hérité de Component) |
|
TableMappings | (hérité de DataAdapter) |
|
UpdateBatchSize | (hérité de DbDataAdapter) |
|
UpdateCommand | Obtient ou définit une instruction SQL utilisée pour mettre à jour les enregistrements dans la source de données. |
Haut de la page
Méthodes
.gif "Méthode protégée")
Haut de la page
Événements
| Nom | Description | |
|---|---|---|
.gif "Événement public") |
Disposed | (hérité de Component) |
|
FillError | (hérité de DataAdapter) |
|
RowUpdated | Se 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. |
|
RowUpdating | Se 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
Implémentations d'interfaces explicites
| Nom | Description | |
|---|---|---|
.gif "Implémentation d'interface explicite") .gif "Méthode privée") |
ICloneable.Clone | Pour une description de ce membre, consultez ICloneable.Clone(). |
.gif "Propriété privée") |
IDbDataAdapter.DeleteCommand | (hérité de DbDataAdapter) |
|
IDbDataAdapter.InsertCommand | (hérité de DbDataAdapter) |
|
IDbDataAdapter.SelectCommand | (hérité de DbDataAdapter) |
|
IDataAdapter.TableMappings | (hérité de DataAdapter) |
|
IDbDataAdapter.UpdateCommand | (hérité de DbDataAdapter) |
Haut de la page
Notes
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.
Exemples
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.
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
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();
}
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.