MoveRecord 方法 (ADO)

將 Record 所代表的實體移至另一個位置。

語法

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

來源
選擇性。一個字串值，包含 URL 用來識別要移動的 Record。如果省略 Source 或指定空字串，則此 Record 所代表的物件就會移動。例如，如果 Record 代表檔案，則檔案的內容會移至 Destination 所指定的位置。

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

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

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

選項
選擇性。一個 MoveRecordOptionsEnum 值，其預設值為 adMoveUnspecified。指定此方法的行為。

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

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

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

對於使用 Internet Publishing Provider 移動的檔案，此方法會更新這些檔案中的所有超文字連結，除非選項另有指定。如果 Destination 識別現有的物件 (例如檔案或目錄)，此方法將會失敗，除非指定了 adMoveOverWrite。

注意

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

Record 物件的某些屬性 (例如 ParentURL 屬性) 將不會在此作業完成後更新。請重新整理 Record 物件的屬性，方法是關閉 Record，然後使用檔案或目錄移到之位置的 URL 將其重新開啟。

如果此記錄是從資料錄集取得的，移動的檔案或目錄的新位置將不會立即反映在資料錄集中。請關閉並重新開啟資料錄集，加以重新整理。

注意

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