MoveRecord メソッド (ADO)

適用先: Access 2013、Office 2013

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

構文

レコード。MoveRecord (Source, Destination, UserName, Password, Options, Async)

パラメーター

パラメーター	説明
Source	省略可能です。 移動する Record を示す URL を含む文字列型 (String) の値を指定します。 Source を省略するか、または空文字列を指定すると、この Record で表されるオブジェクトが移動されます。 たとえば、Record がファイルを表している場合は、ファイルの内容が Destination で指定した場所に移動されます。
宛先	省略可能です。 Source の移動先の場所を指定する URL を含む文字列型 (String) の値を指定します。
UserName	省略可能です。 Destination へのアクセス権が設定されている場合、アクセス権を持つユーザー ID を含む、文字列型 (String) の値を指定します。
Password	省略可能です。 UserName を確認するためのパスワードを含む、文字列型 (String) を指定します。
Options	省略可能です。MoveRecordOptionsEnum 値を指定します。 既定値が adMoveUnspecified である MoveRecordOptionsEnum 値。 このメソッドの動作を指定します。
Async	省略可能です。 True の場合、この操作を非同期にすることを指定するブール値。

戻り値

文字列型 (String) の値を返します。 通常は、Destination の値が返されます。 ただし、実際に返される値はプロバイダーによって異なります。

注釈

Source と Destination の値は同一にすることはできません。それ以外の場合は、実行時エラーが発生します。 少なくとも、サーバー、パス、およびリソース名が異なる必要があります。

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

注:

[!メモ] adMoveOverWrite オプションは十分に注意して使用してください。 たとえば、ファイルをディレクトリに移動するときにこのオプションを指定していると、移動先のディレクトリが "削除" され、移動元のファイルに置き換えられます。

この操作の終了後、 Record オブジェクトの一部の属性 ( ParentURL プロパティなど) は更新されなくなります。 Record オブジェクトのプロパティを更新するには、 Record を閉じ、そのファイルまたはディレクトリが移動された場所の URL でもう一度開いてください。

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

注:

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