Share via

SqlCeDataAdapter 类

  • 项目

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

继承层次结构

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

命名空间：  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

[<SealedAttribute>]
type SqlCeDataAdapter =  
    class
        inherit DbDataAdapter
        interface ICloneable
    end

public final class SqlCeDataAdapter extends DbDataAdapter implements ICloneable

SqlCeDataAdapter 类型公开以下成员。

构造函数

  名称 说明
公共方法 SqlCeDataAdapter() 初始化 SqlCeDataAdapter 类的一个新实例。
公共方法 SqlCeDataAdapter(SqlCeCommand) 初始化 SqlCeDataAdapter 类的一个新实例，用指定的 SqlCeCommand 作为 SelectCommand 的属性。
公共方法 SqlCeDataAdapter(String, SqlCeConnection) 使用 SelectCommand 和 SqlCeConnection 对象初始化 SqlCeDataAdapter 类的一个新实例。
公共方法 SqlCeDataAdapter(String, String) 用 SelectCommand 和一个连接字符串初始化 SqlCeDataAdapter 类的一个新实例。

页首

属性

  名称 说明
公共属性 AcceptChangesDuringFill （继承自 DataAdapter）
公共属性 AcceptChangesDuringUpdate （继承自 DataAdapter）
受保护属性 CanRaiseEvents （继承自 Component）
公共属性 Container （继承自 Component）
公共属性 ContinueUpdateOnError （继承自 DataAdapter）
公共属性 DeleteCommand 获取或设置用于从数据集中删除记录的 SQL 语句。
受保护属性 DesignMode （继承自 Component）
受保护属性 Events （继承自 Component）
受保护属性 FillCommandBehavior （继承自 DbDataAdapter）
公共属性 FillLoadOption （继承自 DataAdapter）
公共属性 InsertCommand 获取或设置用于将新记录插入数据源的 SQL 语句。
公共属性 MissingMappingAction （继承自 DataAdapter）
公共属性 MissingSchemaAction （继承自 DataAdapter）
公共属性 ReturnProviderSpecificTypes （继承自 DataAdapter）
公共属性 SelectCommand 获取或设置用于在数据源中选择记录的 SQL 语句。
公共属性 Site （继承自 Component）
公共属性 TableMappings （继承自 DataAdapter）
公共属性 UpdateBatchSize （继承自 DbDataAdapter）
公共属性 UpdateCommand 获取或设置用于更新数据源中的记录的 SQL 语句。

页首

方法

  名称 说明
受保护方法 AddToBatch （继承自 DbDataAdapter）
受保护方法 ClearBatch （继承自 DbDataAdapter）
受保护方法 CloneInternals 已过时。 （继承自 DataAdapter）
公共方法 CreateObjRef （继承自 MarshalByRefObject）
受保护方法 CreateRowUpdatedEvent （继承自 DbDataAdapter）
受保护方法 CreateRowUpdatingEvent （继承自 DbDataAdapter）
受保护方法 CreateTableMappings （继承自 DataAdapter）
公共方法 Dispose() 处置当前实例。
受保护方法 Dispose(Boolean) （继承自 DbDataAdapter）
公共方法 Equals （继承自 Object）
受保护方法 ExecuteBatch （继承自 DbDataAdapter）
公共方法 Fill(DataSet) （继承自 DbDataAdapter）
公共方法 Fill(DataTable) （继承自 DbDataAdapter）
公共方法 Fill(DataSet, String) （继承自 DbDataAdapter）
受保护方法 Fill(DataTable, IDataReader) （继承自 DataAdapter）
公共方法 Fill(Int32, Int32, array<DataTable[]) （继承自 DbDataAdapter）
受保护方法 Fill(DataTable, IDbCommand, CommandBehavior) （继承自 DbDataAdapter）
公共方法 Fill(DataSet, Int32, Int32, String) （继承自 DbDataAdapter）
受保护方法 Fill(array<DataTable[], IDataReader, Int32, Int32) （继承自 DataAdapter）
受保护方法 Fill(array<DataTable[], Int32, Int32, IDbCommand, CommandBehavior) （继承自 DbDataAdapter）
受保护方法 Fill(DataSet, String, IDataReader, Int32, Int32) （继承自 DataAdapter）
受保护方法 Fill(DataSet, Int32, Int32, String, IDbCommand, CommandBehavior) （继承自 DbDataAdapter）
公共方法 FillSchema(DataTable, SchemaType) （继承自 DbDataAdapter）
公共方法 FillSchema(DataSet, SchemaType) （继承自 DbDataAdapter）
公共方法 FillSchema(DataSet, SchemaType, String) （继承自 DbDataAdapter）
受保护方法 FillSchema(DataTable, SchemaType, IDataReader) （继承自 DataAdapter）
受保护方法 FillSchema(DataTable, SchemaType, IDbCommand, CommandBehavior) （继承自 DbDataAdapter）
受保护方法 FillSchema(DataSet, SchemaType, String, IDataReader) （继承自 DataAdapter）
受保护方法 FillSchema(DataSet, SchemaType, IDbCommand, String, CommandBehavior) （继承自 DbDataAdapter）
受保护方法 Finalize （继承自 Component）
受保护方法 GetBatchedParameter （继承自 DbDataAdapter）
受保护方法 GetBatchedRecordsAffected （继承自 DbDataAdapter）
公共方法 GetFillParameters （继承自 DbDataAdapter）
公共方法 GetHashCode （继承自 Object）
公共方法 GetLifetimeService （继承自 MarshalByRefObject）
受保护方法 GetService （继承自 Component）
公共方法 GetType （继承自 Object）
受保护方法 HasTableMappings （继承自 DataAdapter）
受保护方法 InitializeBatching （继承自 DbDataAdapter）
公共方法 InitializeLifetimeService （继承自 MarshalByRefObject）
受保护方法 MemberwiseClone() （继承自 Object）
受保护方法 MemberwiseClone(Boolean) （继承自 MarshalByRefObject）
受保护方法 OnFillError （继承自 DataAdapter）
受保护方法 OnRowUpdated （继承自 DbDataAdapter）
受保护方法 OnRowUpdating （继承自 DbDataAdapter）
公共方法 ResetFillLoadOption （继承自 DataAdapter）
公共方法 ShouldSerializeAcceptChangesDuringFill （继承自 DataAdapter）
公共方法 ShouldSerializeFillLoadOption （继承自 DataAdapter）
受保护方法 ShouldSerializeTableMappings （继承自 DataAdapter）
受保护方法 TerminateBatching （继承自 DbDataAdapter）
公共方法 ToString （继承自 Component）
公共方法 Update(DataSet) （继承自 DbDataAdapter）
公共方法 Update(array<DataRow[]) （继承自 DbDataAdapter）
公共方法 Update(DataTable) （继承自 DbDataAdapter）
公共方法 Update(DataSet, String) （继承自 DbDataAdapter）
受保护方法 Update(array<DataRow[], DataTableMapping) （继承自 DbDataAdapter）

页首

事件

  名称 说明
公共事件 Disposed （继承自 Component）
公共事件 FillError （继承自 DataAdapter）
公共事件 RowUpdated 在针对数据源执行更新命令之后的调用 Update 期间发生。试图进行更新，于是激发了此事件。
公共事件 RowUpdating 在针对数据源执行更新命令之前的调用 Update 期间发生。试图进行更新，于是激发了此事件。

页首

显式接口实现

  名称 说明
显式接口实现私有方法 ICloneable.Clone 有关此成员的说明，请参阅 ICloneable.Clone()。
显式接口实现私有属性 IDbDataAdapter.DeleteCommand （继承自 DbDataAdapter）
显式接口实现私有属性 IDbDataAdapter.InsertCommand （继承自 DbDataAdapter）
显式接口实现私有属性 IDbDataAdapter.SelectCommand （继承自 DbDataAdapter）
显式接口实现私有属性 IDataAdapter.TableMappings （继承自 DataAdapter）
显式接口实现私有属性 IDbDataAdapter.UpdateCommand （继承自 DbDataAdapter）

页首

注释

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 语句。

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

线程安全

此类型的任何公共静态（在 Microsoft Visual Basic 中为共享）成员是线程安全的。不保证所有实例成员都对于线程安全的。

请参阅

参考

System.Data.SqlServerCe 命名空间

SqlCeConnection

SqlCeCommand

DataSet

DataTable