FileSystemProxy.CopyFile メソッド

定義

名前空間:

Microsoft.VisualBasic.MyServices

アセンブリ:

Microsoft.VisualBasic.Forms.dll

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

オーバーロード

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

CopyFile(String, String)

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

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

public void CopyFile (string sourceFileName, string destinationFileName);

member this.CopyFile : string * string -> unit

Public 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 示します。

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

こちらもご覧ください

• UICancelOption
• オブジェクト (Visual Basic)
• 方法 : Visual Basic で特定のパターンを持つファイルをディレクトリにコピーする
• 方法 : Visual Basic でファイルのコピーを同じディレクトリに作成する
• 方法 : Visual Basic でディレクトリを別のディレクトリにコピーする
• 方法 : Visual Basic でファイルの名前を変更する

CopyFile(String, String, UIOption)

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

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

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

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

Public 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)

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

注釈

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

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

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

こちらもご覧ください

• UICancelOption
• オブジェクト (Visual Basic)
• 方法 : Visual Basic で特定のパターンを持つファイルをディレクトリにコピーする
• 方法 : Visual Basic でファイルのコピーを同じディレクトリに作成する
• 方法 : Visual Basic でディレクトリを別のディレクトリにコピーする
• 方法 : Visual Basic でファイルの名前を変更する

CopyFile(String, String, Boolean)

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

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

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

member this.CopyFile : string * string * bool -> unit

Public 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)

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

注釈

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

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

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

こちらもご覧ください

• UICancelOption
• オブジェクト (Visual Basic)
• 方法 : Visual Basic で特定のパターンを持つファイルをディレクトリにコピーする
• 方法 : Visual Basic でファイルのコピーを同じディレクトリに作成する
• 方法 : Visual Basic でディレクトリを別のディレクトリにコピーする
• 方法 : Visual Basic でファイルの名前を変更する

CopyFile(String, String, UIOption, UICancelOption)

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

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

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

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

Public 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)

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

注釈

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

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

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

こちらもご覧ください

• UICancelOption
• オブジェクト (Visual Basic)
• 方法 : Visual Basic で特定のパターンを持つファイルをディレクトリにコピーする
• 方法 : Visual Basic でファイルのコピーを同じディレクトリに作成する
• 方法 : Visual Basic でディレクトリを別のディレクトリにコピーする
• 方法 : Visual Basic でファイルの名前を変更する