FileSystemProxy.CopyFile メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ファイルを新しい場所にコピーします。
オーバーロード
| 名前 | 説明 |
|---|---|
| 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 -> unitPublic Sub CopyFile (sourceFileName As String, destinationFileName As String)パラメーター
- sourceFileName
- String
コピーするファイル。
- destinationFileName
- String
ファイルのコピー先の場所。
例外
destinationFileName にはパス情報が含まれています。
destinationFileName または sourceFileName が Nothing または空の文字列です。
ソース ファイルが無効であるか、存在しません。
同じ名前のターゲット ディレクトリ内のファイルが使用されています。
パス内のファイル名またはディレクトリ名にコロン (:)または無効な形式が含まれています。
パスがシステム定義の最大長を超えています。
ユーザーに必要なアクセス許可がありません。
ユーザーには、パスを表示するために必要なアクセス許可がありません。
例
次の使用例は、既存のファイルを上書きせずに、ファイル Test.txt をディレクトリ TestFiles2 にコピーします。
My.Computer.FileSystem.CopyFile( _
"C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2\test.txt", overwrite:=False)
ファイル パスを、コードで使用するパスに置き換えます。
次の使用例は、ファイル Test.txt をディレクトリ TestFiles2 にコピーし、 NewFile.txt名前を変更します。
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 -> unitPublic Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)パラメーター
- sourceFileName
- String
コピーするファイル。
- destinationFileName
- String
ファイルのコピー先の場所。
- showUI
- UIOption
操作の進行状況を視覚的に追跡するかどうか。 既定値は UIOption.OnlyErrorDialogs です。
例外
destinationFileName にはパス情報が含まれています。
destinationFileName または sourceFileName が Nothing または空の文字列です。
ソース ファイルが無効であるか、存在しません。
コピー先ファイルが存在し、 overwrite が Falseに設定されています。
パス内のファイル名またはディレクトリ名にコロン (:)または無効な形式が含まれています。
パスがシステム定義の最大長を超えています。
ユーザーに必要なアクセス許可がありません。
ユーザーには、パスを表示するために必要なアクセス許可がありません。
例
次の使用例は、既存のファイルを上書きせずに、ファイル Test.txt をディレクトリ TestFiles2 にコピーします。
My.Computer.FileSystem.CopyFile( _
"C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2\test.txt", overwrite:=False)
ファイル パスを、コードで使用するパスに置き換えます。
次の使用例は、ファイル Test.txt をディレクトリ TestFiles2 にコピーし、 NewFile.txt名前を変更します。
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 -> unitPublic Sub CopyFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)パラメーター
- sourceFileName
- String
コピーするファイル。
- destinationFileName
- String
ファイルのコピー先の場所。
- overwrite
- Boolean
True 既存のファイルを上書きする必要がある場合。それ以外の場合は False。 既定値は False です。
例外
destinationFileName にはパス情報が含まれています。
destinationFileName または sourceFileName が Nothing または空の文字列です。
ソース ファイルが無効であるか、存在しません。
コピー先ファイルが存在し、 overwrite が Falseに設定されています。
パス内のファイル名またはディレクトリ名にコロン (:)または無効な形式が含まれています。
パスがシステム定義の最大長を超えています。
ユーザーに必要なアクセス許可がありません。
ユーザーには、パスを表示するために必要なアクセス許可がありません。
例
次の使用例は、既存のファイルを上書きせずに、ファイル Test.txt をディレクトリ TestFiles2 にコピーします。
My.Computer.FileSystem.CopyFile( _
"C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2\test.txt", overwrite:=False)
ファイル パスを、コードで使用するパスに置き換えます。
次の使用例は、ファイル Test.txt をディレクトリ TestFiles2 にコピーし、 NewFile.txt名前を変更します。
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 -> unitPublic 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 または sourceFileName が Nothing または空の文字列です。
ソース ファイルが無効であるか、存在しません。
コピー先ファイルが存在し、 overwrite が Falseに設定されています。
パス内のファイル名またはディレクトリ名にコロン (:)または無効な形式が含まれています。
パスがシステム定義の最大長を超えています。
ユーザーに必要なアクセス許可がありません。
ユーザーには、パスを表示するために必要なアクセス許可がありません。
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 をディレクトリ TestFiles2 にコピーし、 NewFile.txt名前を変更します。
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 でファイルの名前を変更する