CopyRecord 方法 (ADO)

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

語法

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

參數

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

目的地
選擇性。 包含 URL 的 String 值,指定 將複製 Source 的位置。

使用者名稱
選擇性。 包含使用者識別碼的 String 值,視需要授權存取 Destination

密碼
選擇性。 包含密碼的 String 值,視需要驗證 UserName

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

非同步
選擇性。 布林值,當為 True時,指定此作業應該是非同步。

傳回值

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

備註

SourceDestination的值不得相同;否則,會發生執行階段錯誤。 至少有一個伺服器、路徑或資源名稱必須不同。

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

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

重要

請謹慎使用 adCopyOverWrite 選項。 例如,將檔案複製到目錄時指定這個選項將會 刪除 目錄,並將它取代為 檔案。

注意

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

套用至

Record 物件 (ADO)