CopyRecord メソッド (ADO)

レコードによって表されるエンティティを別の場所にコピーします。

構文

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

ソース
省略可能。コピーされるエンティティ (ファイルやディレクトリなど) を指定する URL を含む String 値。 Source を省略するか、空の文字列を指定すると、現在の Record で表されるファイルやディレクトリがコピーされます。

宛先
任意。 Source がコピーされる場所を指定する URL を含む String 値。

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

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

[オプション]
省略可能。既定値が adCopyUnspecified である CopyRecordOptionsEnum 値。このメソッドの動作を指定します。

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

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

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

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

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

重要

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

注意

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