共用方式為


CopyRecord 方法 (ADO)

記錄所代表的實體複製到另一個位置

語法

  
Record.CopyRecord (Source, Destination, UserName, Password, Options, Async)  

參數

來源
自選。 String 值,其中包含指定要複製之實體的 URL(例如檔案或目錄)。 如果省略 Source 或指定空字串,則會複製目前 Record 所代表的檔案或目錄。

目的地
自選。 String 值,其中包含指定複製來源 位置 的 URL。

UserName
自選。 包含使用者識別碼的 String 值,視需要授權存取 Destination

密碼
自選。 包含所需密碼的 String 值,會驗證 UserName

選項
自選。 CopyRecordOptionsEnum 值,其預設值為 adCopyUnspecified 。 指定這個方法的行為。

異步
自選。 布爾值 值,True時,指定此作業應該是異步的。

傳回值

String 值,通常會傳回 Destination的值。 不過,傳回的確切值是提供者相依的。

言論

來源 目的地 的值不得相同;否則,會發生運行時錯誤。 至少一個伺服器、路徑或資源名稱必須不同。

除非指定 adCopyNonRecursive 否則會以遞歸方式複製 Source 的所有子系(例如子目錄)。 在遞歸作業中,目的地 不得為來源 的子目錄;否則,作業將不會完成。

除非指定 adCopyOverWrite ,否則如果 Destination 識別現有的實體(例如檔案或目錄), 此方法就會失敗。

重要

使用 adCopyOverWrite 選項。 例如,將檔案複製到目錄時指定此選項,刪除目錄,並將它取代為檔案。

注意

使用 HTTP 配置的 URL 會自動叫用 Microsoft OLE DB Provider for Internet Publishing。 如需詳細資訊,請參閱 絕對和相對URL

適用於

Record 物件 (ADO)