CopyRecord メソッド (ADO)

適用先: Access 2013、Office 2013

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

構文

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

パラメーター

パラメーター	説明
Source	省略可能です。 コピー元のエンティティ (ファイル、ディレクトリなど) を指定する URL を含む文字列型 (String) の値を指定します。 Source を省略した場合、または空の文字列を指定した場合、現在の Record で表されているファイルまたはディレクトリがコピーされます。
宛先	省略可能です。 Source のコピー先の場所を指定する URL を含む文字列型 (String) の値を指定します。
UserName	省略可能です。 Destination へのアクセス権が設定されている場合、アクセス権を持つユーザー ID を含む、文字列型 (String) の値を指定します。
Password	省略可能です。 UserName を確認するためのパスワードを含む、文字列型 (String) の値を指定します。
Options	省略可能です。CopyRecordOptionsEnum 値を指定します。 既定値が adCopyUnspecified である CopyRecordOptionsEnum 値。 このメソッドの動作を指定します。
Async	省略可能です。 True の場合、この操作を非同期にすることを指定するブール値。

戻り値

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

注釈

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

adCopyNonRecursive が指定されていない限り、Source のすべての子 (サブディレクトリなど) は再帰的にコピーされます。 再帰的な操作では、 Destination は Source のサブディレクトリにすることはできません。それ以外の場合、操作は完了しません。

Destination に既存のエンティティ (ファイル、ディレクトリなど) を指定する場合、adCopyOverWrite を指定していなければ、このメソッドは失敗します。

重要

Use the adCopyOverWrite option judiciously. たとえば、ディレクトリにファイルをコピーするときにこのオプションを指定すると、ディレクトリが 削除 され、ファイルに置き換えられます。

注:

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