Pull 方法 (RDA)

从远程 Microsoft SQL Server 数据库下载数据，并将该数据存储在位于本地 Microsoft SQL Server 2005 Compact Edition (SQL Server Compact Edition) 数据库内的单个表中。

在调用 Pull 方法前，必须设置下列 RDA 对象属性：

• InternetURL 属性必须包含 SQL Server Compact Edition 服务器代理的 URL。
• LocalConnectionString 属性必须包含设备上 SQL Server Compact Edition 数据库的 OLE DB 连接字符串。
• 如果 SQL Server Compact Edition 服务器代理配置为使用基本身份验证或集成身份验证，则必须指定 InternetLogin 和 InternetPassword 属性。

语法

object.Pull (localTableName, sqlSelectString, oledbConnectionString,  RDA_TRACKOPTION, ErrorTableName)

参数

• LocalTableName
  接收被提取 SQL Server 记录的 SQL Server Compact Edition 表的名称。如果该表已存在，将出现错误。

• SQLSelectString
  一个字符串，指定要从 SQL Server 数据库中提取并存储到 SQL Server Compact Edition 数据库中的表、列和记录。该字符串可以是返回行的任意有效 SQL 语句，包括 SELECT 语句或存储过程。

• OLEDBConnectionString
  连接到 SQL Server 数据库时使用的 OLE DB 连接字符串。有关详细信息，请参阅 SQL Server Compact Edition 远程数据访问编程。

• RDA_TRACKOPTION
  RDA_TRACKOPTION 枚举指示是否跟踪对所请求表进行的更改。当请求索引时，正在请求的表上的索引将被传递到具有 PRIMARY KEY 约束的设备。有关详细信息，请参阅 RDA_TRACKOPTION。

• ErrorTableName
  本地错误表的名称。在以后调用 Push 方法将更改发送回 SQL Server 时，如果出现错误则会创建该表。只有在 RDA_TRACKOPTION 设置为 TRACKINGON 时，才可以指定该选项。

适用范围

SQL Server Compact Edition RemoteDataAccess 对象

备注

SQLSelectString

SQLSelectString 参数控制从 SQL Server 表中请求哪些数据。在使用 SQLSelectString 参数时，请考虑以下问题：

• SQLSelectString 参数可以指定 WHERE 子句来控制返回哪些记录。例如，SELECT * FROM Address WHERE PostalCode='93868' 只检索指定邮政编码的地址。
• SQLSelectString 支持返回行的存储过程和视图。
• SQLSelectString 可以将所选列从多个表中请求到一个表中，但前提是 RDA_TRACKOPTION 参数设置为 TRACKINGOFF。
• 如果结果记录集包含不支持的数据类型（例如 timestamp），将出现错误。

ErrorTableName

ErrorTableName 参数指定将要存储错误的表名称，这些错误是在推送期间遇到的。如果在应用程序调用 Push 方法时出现错误，SQL Server Compact Edition 将创建错误表并向表中添加发生的每个错误的记录。在 Push 方法完成后，应用程序可以检查错误表来确定是否已出现错误。只有在指定 TRACKINGON 或 TRACKINGONWITHINDEXES 时，才可以指定 ErrorTableName。有关错误表工作方式的详细信息，请参阅RDA 冲突检测和报告。

请参阅

参考

RDA 对象方法
Push 方法 (RDA)

帮助和信息

获取 SQL Server Compact Edition 帮助