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。