MoveRecord 方法（ADO）

語法

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

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

目的地
自選。 String 值，其中包含指定來源移動位置的 URL。

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

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

選項
自選。 MoveRecordOptionsEnum 值，其預設值為 adMoveUnspecified。指定這個方法的行為。

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

String 值。一般而言，會傳回 Destination 的值。不過，傳回的確切值是提供者相依的。

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

對於使用因特網發佈提供者移動的檔案，除非 Options另有指定，否則此方法會更新要移動之檔案中的所有超文本連結。 除非指定 adMoveOverWrite，否則如果 Destination 識別現有的物件（例如檔案或目錄），此方法就會失敗。

注意

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

Record 物件的某些屬性，例如 ParentURL 屬性，將不會在此作業完成之後更新。藉由關閉 Record來重新整理 Record 物件的屬性，然後使用檔案或目錄移動位置的 URL 重新開啟它。

如果從 Recordset取得此 Record，則移動檔案或目錄的新位置將不會立即反映在 Recordset中。關閉並重新開啟 Recordset。

注意

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