Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)
The SqlCeDataAdapter serves as a bridge between a DataSet and data source. It is used for retrieving data from, and saving data to, the data source. The SqlCeDataAdapter provides this bridge by using Fill to load data from the data source into the DataSet, and using Update to send changes made in the DataSet back to the data source.
When the SqlCeDataAdapter fills a DataSet, it creates the necessary tables and columns for the returned data if they do not already exist. However, primary key information will not be included in the implicitly created schema unless the MissingSchemaAction property is set to AddWithKey. You can also have the SqlCeDataAdapter create the schema of the DataSet, including primary key information, before filling it with data by using FillSchema.
When you create an instance of SqlCeDataAdapter, properties are set to their initial values. For a list of these values, see the SqlCeDataAdapter constructor.
The following example uses the SqlCeCommand, SqlCeDataAdapter, and SqlCeConnection to select records from a data source and populate a DataSet with the selected rows. The populated DataSet is then returned. To accomplish this, the method is passed an initialized DataSet, a connection string, and a query string that is an SQL SELECT statement.
SqlCeConnection conn = new SqlCeConnection("Data Source = AdventureWorks.sdf"); SqlCeCommand selectCmd = conn.CreateCommand(); selectCmd.CommandText = "SELECT * FROM DimEmployee"; 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);
Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows XP Professional x64 Edition, Windows XP SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.