Synchronize 方法 (RDS)
將指定的 Recordset 與連接字串所指定的資料庫同步處理,以用於 ADO 2.5 和更新版本。
重要
從 Windows 8 和 Windows Server 2012 開始,RDS 伺服器元件已不再包含在 Windows 作業系統中(如需詳細資訊,請參閱 Windows 8 和 Windows Server 2012 兼容性 Cookbook)。 RDS 用戶端元件將在未來的 Windows 版本中移除。 請避免在新的開發工作中使用此功能,並計劃修改目前使用此功能的應用程式。 使用 RDS 的應用程式應該移至 WCF Data Service。
語法
object.Synchronize(ConnectionString As String, HandlerString As String, lSynchronizeOptions As Long, ppRecordset As Object, pStatusArray, [lcid As Long], [pInformation)
參數
ConnectionString
字串,用來連線到將傳送要求的 OLE DB 提供者。 如果使用處理程式,處理程式可以編輯或取代連接字串。
HandlerString
字串會識別要與這個執行搭配使用的處理程式。 字串包含兩個部分。 第一個部分包含要使用的處理程式名稱(ProgID)。 字串的第二個部分包含要傳遞至處理程式的自變數。 如何解譯自變數字串是處理程式特定的。 這兩個部分會以字串中逗號的第一個實例分隔(雖然自變數字串可能包含其他逗號)。 自變數是選擇性的。
lSynchronizeOptions
同步處理選項的位遮罩。
1=UpdateTransact 資料庫更新會包裝在交易中。 如果有任何更新失敗,交易就會中止。
2=RefreshWithUpdate 當未設定 refresh 或 RefreshConflicts 時,都會傳回數據列狀態。
4=重新整理 記錄集會使用資料庫中的目前數據重新整理。 擱置的更新不會推送至資料庫。 如果未設定此位,則不會重新整理記錄集,而且會將任何擱置的更新推送至資料庫。
8=RefreshConflicts 任何暫止變更的數據列都無法更新。 無法更新的數據列會以資料庫目前的數據重新整理。
ppRecordset
要同步處理的記錄集指標。
pStatusArray
變數,用來傳回受同步處理影響之數據列之數據列狀態的安全數位。 如果未設定下列任何同步處理選項,則不會設定:RefreshWithUpdate、Refresh 和 RefreshConflicts。
lcid
LCID 用來建置 pInformation中傳回的任何錯誤。
pInformation
Execute所傳回之資訊錯誤的指標。 如果為 NULL,則不會傳回任何錯誤資訊。
言論
HandlerString 參數可能是 null。 在此情況下,會發生什麼情況取決於 RDS 伺服器的設定方式。 “MSDFMAP.handler” 的處理程式字串表示應該使用Microsoft提供的處理程式(Msdfmap.dll)。 “MASDFMAP.handler,sample.ini” 的處理程式字串表示應該使用 Msdfmap.dll 處理程式,而且應該將自變數 “sample.ini” 傳遞給處理程式。 Msdfmap.dll 接著會將自變數解譯為使用 sample.ini 檢查連線和查詢字串的方向。