CopyRecord メソッド (ADO)
レコード によって表されるエンティティを別の場所にコピーします。
構文
Record.CopyRecord (Source, Destination, UserName, Password, Options, Async)
パラメーター
ソース
随意。 コピーするエンティティ (ファイルやディレクトリなど) を指定する URL を含む 文字列 値です。 ソース 省略するか、空の文字列を指定すると、現在の Record によって表されるファイルまたはディレクトリがコピーされます。
Destination
随意。 ソース をコピーする場所を指定する URL を含む 文字列 値。
UserName の
随意。 必要に応じて宛先 へのアクセスを承認するユーザー ID を含む 文字列 値指定します。
パスワードの
随意。 必要に応じて UserName を検証するパスワードを含む 文字列 値。
オプションの
随意。 adCopyUnspecified の既定値を持つ CopyRecordOptionsEnum 値。 このメソッドの動作を指定します。
非同期 の
随意。 true 場合、この操作を非同期にすることを指定する ブール 値です。
戻り値
文字列 値。通常は、Destination の値返されます。 ただし、返される正確な値はプロバイダーに依存します。
備考
ソース と Destination の値は同じにすることはできません。それ以外の場合は、実行時エラーが発生します。 サーバー名、パス名、またはリソース名の少なくとも 1 つが異なる必要があります。
adCopyNonRecursive が指定されていない限り、ソース のすべての子 (サブディレクトリなど) 再帰的にコピーされます。 再帰的な操作では、Destination をソース のサブディレクトリすることはできません。それ以外の場合、操作は完了しません。
adCopyOverWrite が指定されていない限り、Destination が既存のエンティティ (ファイルやディレクトリなど) を識別する場合、このメソッドは失敗。
大事な
adCopyOverWrite オプションを慎重に使用してください。 たとえば、ファイルをディレクトリにコピーするときにこのオプションを指定すると、ディレクトリ 削除、ファイルに置き換えられます。
手記
http スキームを使用する URL は、Microsoft OLE DB Provider for Internet Publishingを自動的に呼び出します。 詳細については、「絶対 URL と相対 URL を参照してください。