MoveRecord メソッド (ADO)
Record によって表されるエンティティを別の場所に移動します。
構文
Record.MoveRecord (Source, Destination, UserName, Password, Options, Async)
パラメーター
ソース
随意。 移動する レコード を識別する URL を含む 文字列 値。 source 省略するか、空の文字列を指定すると、この Record によって表されるオブジェクトが移動されます。 たとえば、レコード がファイルを表す場合、ファイルの内容は、Destinationで指定された場所に移動されます。
Destination
随意。 ソース を移動する場所を指定する URL を含む 文字列 値。
UserName の
随意。 必要に応じて宛先 へのアクセスを承認するユーザー ID を含む 文字列 値指定します。
パスワードの
随意。 必要に応じて UserName 検証するパスワードを含む 文字列。
オプションの
随意。 既定値が adMoveUnspecified である MoveRecordOptionsEnum 値。 このメソッドの動作を指定します。
非同期 の
随意。 true 場合、この操作を非同期にすることを指定する ブール 値。
戻り値
文字列 値。 通常、Destination の値 返されます。 ただし、返される正確な値はプロバイダーに依存します。
備考
ソース と Destination の値は同じにすることはできません。それ以外の場合は、実行時エラーが発生します。 少なくとも、サーバー名、パス名、およびリソース名は異なる必要があります。
インターネット公開プロバイダーを使用して移動されたファイルの場合、このメソッドは、オプションで特に指定されていない限り、移動するファイル内のすべてのハイパーテキスト リンクを更新します。 adMoveOverWrite が指定されていない限り、Destination が既存のオブジェクト (ファイルやディレクトリなど) を識別 場合、このメソッドは失敗します。
手記
adMoveOverWrite オプションを慎重に使用してください。 たとえば、ファイルをディレクトリに移動するときにこのオプションを指定すると、ディレクトリが削除され、ファイルに置き換えられます。
ParentURL プロパティなど、Record オブジェクトの特定の属性は、この操作の完了後に更新されません。 Recordを閉じて、Record オブジェクトのプロパティを更新し、ファイルまたはディレクトリが移動された場所の URL で再度開きます。
この レコード が Recordsetから取得された場合、移動されたファイルまたはディレクトリの新しい場所は、Recordsetにすぐに反映されません。 Recordset を閉じて再度開いて更新します。
手記
http スキームを使用する URL は、Microsoft OLE DB Provider for Internet Publishingを自動的に呼び出します。 詳細については、「絶対 URL と相対 URL を参照してください。
適用対象
関連項目
Move メソッド (ADO)
MoveFirst、MoveLast、MoveNext、および MovePrevious メソッド (ADO)
MoveFirst、MoveLast、MoveNext、および MovePrevious メソッド (RDS)