Synchronize 方法 (RDS)

  • 發行項

將指定的資料錄集與連接字串所指定的資料庫進行同步 (以便在 ADO 2.5 和更新版本中使用)。

重要

從 Windows 8 和 Windows Server 2012 開始，Windows 作業系統中不再包含 RDS 伺服器元件 (請參閱 Windows 8 和 Windows Server 2012 相容性操作手冊以取得詳細資訊)。 未來的 Windows 版本將移除 RDS 用戶端元件。 請避免在新的開發工作中使用這項功能，並規劃修改目前使用這項功能的應用程式。 使用 RDS 的應用程式應該移轉至 WCF 資料服務。

語法

  
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=Refresh，資料錄集會以資料庫中目前的資料重新整理。 擱置中的更新，將不會推送至資料庫。 如果未設定此位元，則不會重新整理資料錄集，且所有擱置中的更新，都會推送至資料庫。

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 來檢查連線和查詢字串的指示。

套用至

DataFactory 物件 (RDSServer)