SqlCeDataAdapter 类

项目
08/17/2007

表示一组数据命令和一个数据库连接，它们用于填充 DataSet 和更新数据源。

命名空间: System.Data.SqlServerCe
程序集: System.Data.SqlServerCe（在 system.data.sqlserverce.dll 中）

语法

声明
Public NotInheritable Class SqlCeDataAdapter
    Inherits DbDataAdapter
    Implements ICloneable
用法
Dim instance As SqlCeDataAdapter

public sealed class SqlCeDataAdapter : DbDataAdapter, ICloneable

public ref class SqlCeDataAdapter sealed : public DbDataAdapter, ICloneable

public final class SqlCeDataAdapter extends DbDataAdapter implements ICloneable

public final class SqlCeDataAdapter extends DbDataAdapter implements ICloneable

不适用。

备注

SqlCeDataAdapter 可作为 DataSet 和数据源之间的桥接器。它可用于从数据源检索数据，也可用于将数据保存到数据源。SqlCeDataAdapter 通过以下方法提供这个桥接器：使用 Fill 将数据从数据源加载到 DataSet 中，并使用 Update 将 DataSet 中所作的更改发回数据源。

当 SqlCeDataAdapter 填充 DataSet 时，它将为返回的数据创建必需的表和列（如果它们尚不存在）。但是，除非 MissingSchemaAction 属性设置为 AddWithKey，否则这个隐式创建的架构中就将不包括主键信息。您也可以让 SqlCeDataAdapter 创建 DataSet 的架构，并在使用 FillSchema 向架构填充数据之前就将主键信息包括进去。

SqlCeDataAdapter 包括 SelectCommand、InsertCommand、DeleteCommand、UpdateCommand 和 TableMappings 属性，为数据的加载和更新提供便利。

当创建 SqlCeDataAdapter 的实例时，属性都设置为其初始值。有关这些值的列表，请参见 SqlCeDataAdapter 构造函数。

示例

下面的示例使用 SqlCeCommand、SqlCeDataAdapter 和 SqlCeConnection，来从数据源选择记录并用选定的行填充 DataSet。然后，将返回已填充的 DataSet。为完成此任务，向该方法传递一个已初始化的 DataSet、一个连接字符串和一个查询字符串，后者是一个 SQL SELECT 语句。

Dim conn As New SqlCeConnection("Data Source = AdventureWorks.sdf")

Dim selectCmd As SqlCeCommand = conn.CreateCommand()
selectCmd.CommandText = "SELECT * FROM DimEmployee"

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)

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);

继承层次结构

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

线程安全

此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。

平台

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Windows Vista、Microsoft Windows XP SP2 和 Windows Server 2003 SP1 支持 Microsoft .NET Framework 3.0。

版本信息

.NET Framework

受以下版本支持：3.0

.NET Compact Framework

受以下版本支持：2.0、1.0

请参见

参考

SqlCeDataAdapter 成员
 System.Data.SqlServerCe 命名空间
 SqlCeConnection
SqlCeCommand
DataSet
DataTable

通过