MoveRecord 方法 (ADO)

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

語法

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

參數

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

目的地
選擇性。 包含 URL 的 String 值,指定 來源 將移動的位置。

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

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

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

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

傳回值

字串值。 一般而言,會傳回 Destination 的值。 不過,傳回的確切值與提供者相依。

備註

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

對於使用網際網路發佈提供者移動的檔案,除非選項另有指定,否則此方法會更新檔案中的所有超文字連結。 如果 Destination 識別現有的物件 (,例如檔案或目錄) ,除非指定 adMoveOverWrite ,否則此方法會失敗。

注意

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

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

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

注意

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

套用至

Record 物件 (ADO)

另請參閱

Move 方法 (ADO)
MoveFirst、MoveLast、MoveNext 和 MovePrevious 方法 (ADO)
MoveFirst、MoveLast、MoveNext 和 MovePrevious 方法 (RDS)