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 衝突偵測和報告＞。