CopyRecord 方法 (ADO)

將 Record 所代表的實體複製到另一個位置。

語法

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

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

目的地
選擇性。一個字串值，包含 URL 用來指定 Source 所將複製到的位置。

使用者名稱
選擇性。一個字串值，包含使用者識別碼，可視需要授與存取 Destination 的權限。

密碼
選擇性。一個字串值，其中包含的密碼可視需要用來驗證 UserName。

選項
選擇性。一個 CopyRecordOptionsEnum 值，具有預設值 adCopyUnspecified。指定此方法的行為。

非同步
選擇性。一個布林值，值為 True 時，會指定作業應為非同步作業。

一個字串值，通常會傳回 Destination 的值。不過，傳回的確切值取決於提供者。

Source 和 Destination 的值不可相同；否則會發生執行階段錯誤。至少必須有一個伺服器、路徑或資源名稱不同。

Source 的所有子系 (例如子目錄) 都會以遞迴方式複製，除非指定了 adCopyNonRecursive。在遞迴作業中，Destination 不可以是 Source 的子目錄，否則作業將無法完成。

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

重要

請謹慎使用 adCopyOverWrite 選項。例如，將檔案複製到目錄時若指定此選項，將會刪除目錄，並將其取代為檔案。

注意

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