FileCopy 関数

[アーティクル]
09/30/2008

更新 : 2007 年 11 月

ファイルをコピーします。

My.Computer.FileSystem オブジェクトを使用すると、FileCopy を使用するよりもファイル I/O 処理の生産性とパフォーマンスが格段に向上します。詳細については、「My.Computer.FileSystem.CopyFile メソッド」を参照してください。

Public Sub FileCopy( _
   ByVal Source As String, _
   ByVal Destination As String _
)

パラメータ

Source
必ず指定します。コピーするファイル名を指定する String 式です。Source には、コピー元ファイルのディレクトリ名やフォルダ名、およびドライブ名を指定できます。
Destination
必ず指定します。コピー先のファイル名を指定する String 式です。Destination にはコピー先ファイルのディレクトリ名やフォルダ名、およびドライブ名を指定できます。

例外

例外の種類	エラー番号	条件
ArgumentException	52	Source または Destination が無効であるか、指定されていません。
IOException	55	ファイルが既に開かれています。
FileNotFoundException	53	ファイルが存在していません。

非構造化エラー処理を使用する Visual Basic 6.0 アプリケーションをアップグレードする場合は、"エラー番号" の列を参照してください(エラー番号を Number プロパティ (Err オブジェクト) と比較することもできます)。ただし、可能であれば、このようなエラー制御は Visual Basic の構造化例外処理の概要に置き換えることを検討してください。

解説

現在開いているファイルに対して FileCopy 関数を使用しようとすると、エラーが発生します。

FileCopy をローカルドライブで使用するには、完全な信頼が必要です。

使用例

FileCopy 関数を使って、ファイルを別のファイルにコピーするコード例を次に示します。この例では、SrcFile はデータを含むファイルであると仮定します。

Dim SourceFile, DestinationFile As String
SourceFile = "SRCFILE"   ' Define source file name.
DestinationFile = "DESTFILE"   ' Define target file name.
FileCopy(SourceFile, DestinationFile)   ' Copy source to target.