FileSystem.CopyFile メソッド

リファレンス

定義

名前空間:: Microsoft.VisualBasic.FileIO

アセンブリ:: Microsoft.VisualBasic.Core.dll

アセンブリ:: Microsoft.VisualBasic.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ファイルを新しい場所にコピーします。

オーバーロード

CopyFile(String, String)	ファイルを新しい場所にコピーします。
CopyFile(String, String, UIOption)	ファイルを新しい場所にコピーします。
CopyFile(String, String, Boolean)	ファイルを新しい場所にコピーします。
CopyFile(String, String, UIOption, UICancelOption)	ファイルを新しい場所にコピーします。

CopyFile(String, String)

ソース:: FileSystem.vb

ソース:: FileSystem.vb

ソース:: FileSystem.vb

ファイルを新しい場所にコピーします。

public:
 static void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName);

public static void CopyFile (string sourceFileName, string destinationFileName);

static member CopyFile : string * string -> unit

Public Shared Sub CopyFile (sourceFileName As String, destinationFileName As String)

パラメーター

sourceFileName: String

コピーするファイル。

destinationFileName: String

ファイルのコピー先となる場所。

例外

ArgumentException

destinationFileName にパス情報が含まれています。

ArgumentNullException

destinationFileName または sourceFileName が Nothing または空の文字列です。

FileNotFoundException

ソースファイルが有効でないか、存在しません。

IOException

コピー先のディレクトリにある同じ名前のファイルが使用中です。

NotSupportedException

パス内のファイル名またはディレクトリ名にコロン (:) が含まれているか、形式が無効です。

PathTooLongException

パスがシステム定義の最大長を超えています。

UnauthorizedAccessException

ユーザーに必要なアクセス許可がありません。

SecurityException

ユーザーがパスを参照するのに必要なアクセス許可を保持していません。

例

次の使用例は、既存のファイル Test.txt を上書きせずにファイルをディレクトリにコピーします TestFiles2 。

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

ファイルパスを、コードで使用するパスに置き換えます。

次の使用例は、ファイルTest.txtをディレクトリにコピーし、名前NewFile.txtを変更しますTestFiles2。

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

ファイルパスを、コードで使用するパスに置き換えます。

注釈

CopyFileは ACE (Access Control エントリ) を保持しません。新しく作成されたファイルは、そのファイルが作成されたディレクトリから既定の ACE を継承します。

次の表に、メソッドに関連するタスクの例を My.Computer.FileSystem.CopyFile 示します。

終了	解決方法については、
ファイルを同じディレクトリにコピーします。	方法 : Visual Basic でファイルのコピーを同じディレクトリに作成する
ファイルを別のディレクトリにコピーします。	方法 : Visual Basic でファイルのコピーを別のディレクトリに作成する

こちらもご覧ください

UICancelOption

適用対象

CopyFile(String, String, UIOption)

ソース:: FileSystem.vb

ソース:: FileSystem.vb

ソース:: FileSystem.vb

ファイルを新しい場所にコピーします。

public:
 static void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);

public static void CopyFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);

static member CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit

Public Shared Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

パラメーター

sourceFileName: String

コピーするファイル。

destinationFileName: String

ファイルのコピー先となる場所。

showUI: UIOption

操作の進行状況を視覚的に追跡するかどうか。既定値は UIOption.OnlyErrorDialogs です。

例外

ArgumentException

destinationFileName にパス情報が含まれています。

ArgumentNullException

destinationFileName または sourceFileName が Nothing または空の文字列です。

FileNotFoundException

ソースファイルが有効でないか、存在しません。

IOException

移動先にファイルが既に存在し、overwrite が False に設定されています。

NotSupportedException

パス内のファイル名またはディレクトリ名にコロン (:) が含まれているか、形式が無効です。

PathTooLongException

パスがシステム定義の最大長を超えています。

UnauthorizedAccessException

ユーザーに必要なアクセス許可がありません。

SecurityException

ユーザーがパスを参照するのに必要なアクセス許可を保持していません。

例

次の使用例は、既存のファイル Test.txt を上書きせずにファイルをディレクトリにコピーします TestFiles2 。

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

ファイルパスを、コードで使用するパスに置き換えます。

次の使用例は、ファイルTest.txtをディレクトリにコピーし、名前NewFile.txtを変更しますTestFiles2。

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

ファイルパスを、コードで使用するパスに置き換えます。

注釈

次の表に、メソッドに関連するタスクの例を My.Computer.FileSystem.CopyFile 示します。

終了	解決方法については、
ファイルを同じディレクトリにコピーします。	方法 : Visual Basic でファイルのコピーを同じディレクトリに作成する
ファイルを別のディレクトリにコピーします。	方法 : Visual Basic でファイルのコピーを別のディレクトリに作成する

こちらもご覧ください

UICancelOption

適用対象

CopyFile(String, String, Boolean)

ソース:: FileSystem.vb

ソース:: FileSystem.vb

ソース:: FileSystem.vb

ファイルを新しい場所にコピーします。

public:
 static void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);

public static void CopyFile (string sourceFileName, string destinationFileName, bool overwrite);

static member CopyFile : string * string * bool -> unit

Public Shared Sub CopyFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

パラメーター

sourceFileName: String

コピーするファイル。

destinationFileName: String

ファイルのコピー先となる場所。

overwrite: Boolean

既存のファイルを上書きする場合は True。それ以外の場合は False。既定値は False です。

例外

ArgumentException

destinationFileName にパス情報が含まれています。

ArgumentNullException

destinationFileName または sourceFileName が Nothing または空の文字列です。

FileNotFoundException

ソースファイルが有効でないか、存在しません。

IOException

移動先にファイルが既に存在し、overwrite が False に設定されています。

NotSupportedException

パス内のファイル名またはディレクトリ名にコロン (:) が含まれているか、形式が無効です。

PathTooLongException

パスがシステム定義の最大長を超えています。

UnauthorizedAccessException

ユーザーに必要なアクセス許可がありません。

SecurityException

ユーザーがパスを参照するのに必要なアクセス許可を保持していません。

例

次の使用例は、既存のファイル Test.txt を上書きせずにファイルをディレクトリにコピーします TestFiles2 。

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

ファイルパスを、コードで使用するパスに置き換えます。

次の使用例は、ファイルTest.txtをディレクトリにコピーし、名前NewFile.txtを変更しますTestFiles2。

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

ファイルパスを、コードで使用するパスに置き換えます。

注釈

次の表に、メソッドに関連するタスクの例を My.Computer.FileSystem.CopyFile 示します。

終了	解決方法については、
ファイルを同じディレクトリにコピーします。	方法 : Visual Basic でファイルのコピーを同じディレクトリに作成する
ファイルを別のディレクトリにコピーします。	方法 : Visual Basic でファイルのコピーを別のディレクトリに作成する

こちらもご覧ください

UICancelOption

適用対象

CopyFile(String, String, UIOption, UICancelOption)

ソース:: FileSystem.vb

ソース:: FileSystem.vb

ソース:: FileSystem.vb

ファイルを新しい場所にコピーします。

public:
 static void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public static void CopyFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

static member CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Shared Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)

パラメーター

sourceFileName: String

コピーするファイル。

destinationFileName: String

ファイルのコピー先となる場所。

showUI: UIOption

操作の進行状況を視覚的に追跡するかどうか。既定値は UIOption.OnlyErrorDialogs です。

onUserCancel: UICancelOption

操作中にユーザーが [キャンセル] をクリックした場合の処理を指定します。既定値は ThrowException です。

例外

ArgumentException

destinationFileName にパス情報が含まれています。

ArgumentNullException

destinationFileName または sourceFileName が Nothing または空の文字列です。

FileNotFoundException

ソースファイルが有効でないか、存在しません。

IOException

移動先にファイルが既に存在し、overwrite が False に設定されています。

NotSupportedException

パス内のファイル名またはディレクトリ名にコロン (:) が含まれているか、形式が無効です。

PathTooLongException

パスがシステム定義の最大長を超えています。

UnauthorizedAccessException

ユーザーに必要なアクセス許可がありません。

SecurityException

ユーザーがパスを参照するのに必要なアクセス許可を保持していません。

OperationCanceledException

UICancelOption が ThrowException に設定されている場合にユーザーが操作を取り消したか、不特定の I/O エラーが発生しました。

例

次の使用例は、既存のファイル Test.txt を上書きせずにファイルをディレクトリにコピーします TestFiles2 。

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

ファイルパスを、コードで使用するパスに置き換えます。

次の使用例は、ファイルTest.txtをディレクトリにコピーし、名前NewFile.txtを変更しますTestFiles2。

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

ファイルパスを、コードで使用するパスに置き換えます。

注釈

次の表に、メソッドに関連するタスクの例を My.Computer.FileSystem.CopyFile 示します。

終了	解決方法については、
ファイルを同じディレクトリにコピーします。	方法 : Visual Basic でファイルのコピーを同じディレクトリに作成する
ファイルを別のディレクトリにコピーします。	方法 : Visual Basic でファイルのコピーを別のディレクトリに作成する

こちらもご覧ください

UICancelOption

適用対象

次の方法で共有

FileSystem.CopyFile メソッド

定義

オーバーロード

CopyFile(String, String)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

CopyFile(String, String, UIOption)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

CopyFile(String, String, Boolean)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

CopyFile(String, String, UIOption, UICancelOption)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

その他のリソース