次の方法で共有


FileSystemProxy.CopyFile メソッド

定義

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

オーバーロード

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

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

例外

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

destinationFileName または sourceFileNameNothing または空の文字列です。

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

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

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

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

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

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

次の使用例は、既存のファイル 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 示します。

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

こちらもご覧ください

適用対象

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 です。

例外

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

destinationFileName または sourceFileNameNothing または空の文字列です。

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

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

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

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

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

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

次の使用例は、既存のファイル 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 示します。

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

こちらもご覧ください

適用対象

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 です。

例外

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

destinationFileName または sourceFileNameNothing または空の文字列です。

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

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

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

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

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

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

次の使用例は、既存のファイル 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 示します。

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

こちらもご覧ください

適用対象

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 です。

例外

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

destinationFileName または sourceFileNameNothing または空の文字列です。

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

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

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

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

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

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

UICancelOptionThrowException に設定されている場合にユーザーが操作を取り消したか、不特定の 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 示します。

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

こちらもご覧ください

適用対象