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 冲突检测和报告。