MoveRecord メソッド (ADO)

Record によって表されるエンティティを別の場所に移動します。

構文

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

パラメーター

ソース
省略可能。 移動する Record を識別する URL が含まれている String 値。 Source を省略するか、空の文字列を指定すると、この Record によって表されるオブジェクトが移動されます。 たとえば、Record があるファイルを表す場合、そのファイルの内容は Destination で指定した場所に移動されます。

宛先
任意。 Source を移動する場所を指定した URL を含む String 値。

UserName
省略可能。 必要な場合に Destination へのアクセスを承認するユーザー ID を含む String 値。

パスワード
省略可能。 必要な場合に UserName を検証するパスワードを含む String。

[オプション]
省略可能。 MoveRecordOptionsEnum 値。既定値は adMoveUnspecified です。 このメソッドの動作を指定します。

非同期
省略可能。 Boolean 値。True のとき、この操作を非同期にすることを指定します。

戻り値

文字列値です。 通常、Destination の値が返されます。 ただし、返される正確な値はプロバイダーに依存します。

注釈

Source と Destination の値は同じにすることができません。そうでないと、実行時エラーが発生します。 少なくともサーバー、パス、リソースの名前は異なっている必要があります。

インターネット発行プロバイダーを使用して移動されるファイルの場合、このメソッドを使うと、Options で特に指定されていない限り、移動するファイル内のすべてのハイパーテキスト リンクが更新されます。 Destination が既存のオブジェクト (ファイルやディレクトリなど) を指す場合、adMoveOverWrite が指定されていない限り、このメソッドは失敗します。

注意

adMoveOverWrite オプションは慎重に使用してください。 たとえば、ファイルをディレクトリに移動するときにこのオプションを指定すると、そのディレクトリは削除されて、ファイルに置き換えられます。

Record オブジェクトの特定の属性 (ParentURL プロパティなど) は、この操作が完了しても更新されません。 Record オブジェクトのプロパティを更新するには、Record を閉じてから、ファイルまたはディレクトリが移動された場所の URL でもう一度開きます。

この Record が Recordset から取得された場合、移動したファイルまたはディレクトリの新しい場所は、Recordset にすぐに反映されません。 Recordset を閉じてもう一度開くことで、更新してください。

注意

http スキームを使用する URL は、Microsoft OLE DB Provider for Internet Publishing を自動的に呼び出します。 詳細については、「絶対 URL と相対 URL」を参照してください。

適用対象

Record オブジェクト (ADO)

参照

Move メソッド (ADO)
MoveFirst、MoveLast、MoveNext、および MovePrevious メソッド (ADO)
MoveFirst、MoveLast、MoveNext、MovePrevious メソッド (RDS)