FileSystemProxy.CopyDirectory メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
あるディレクトリを別のディレクトリにコピーします。
オーバーロード
| CopyDirectory(String, String) |
あるディレクトリを別のディレクトリにコピーします。 |
| CopyDirectory(String, String, UIOption) |
あるディレクトリを別のディレクトリにコピーします。 |
| CopyDirectory(String, String, Boolean) |
あるディレクトリを別のディレクトリにコピーします。 |
| CopyDirectory(String, String, UIOption, UICancelOption) |
あるディレクトリを別のディレクトリにコピーします。 |
CopyDirectory(String, String)
あるディレクトリを別のディレクトリにコピーします。
public:
void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName);public void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName);member this.CopyDirectory : string * string -> unitPublic Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String)パラメーター
- sourceDirectoryName
- String
コピーするディレクトリ。
- destinationDirectoryName
- String
ディレクトリのコピー先の場所。
例外
パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。または、デバイス パスです (\\.\で始まります)。
destinationDirectoryName または sourceDirectoryName が Nothing または空の文字列です。
コピー元のディレクトリが存在しません。
コピー元とコピー先のパスが同じです。
操作が巡回しています。
パスがシステム定義の最大長を超えています。
パス内のフォルダー名にコロン (:) が含まれているか、形式が無効です。
ユーザーがパスを参照するのに必要なアクセス許可を保持していません。
コピー先のファイルは存在しますが、アクセスできません。
例
次の例では、 ディレクトリを にTestDirectory2コピーし、既存のファイルを上書きしますTestDirectory1。
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
と C:\TestDirectory2 を、コピーするディレクトリのパスと名前、およびコピー先の場所に置き換えますC:\TestDirectory1。
注釈
このメソッドでは、ディレクトリ自体とその内容がコピーされます。 ターゲット ディレクトリが存在しない場合は、作成されます。 ターゲットの場所に同じ名前のディレクトリが存在する場合、2 つのディレクトリの内容がマージされます。 操作中に、ディレクトリに新しい名前を指定できます。
ディレクトリ内のファイルをコピーするときに、特定のファイルによって発生する例外がスローされる場合があります。 このような例外がスローされると、ファイルまたはディレクトリ パスがキーであり、特定の例外 Data メッセージが対応する値に含まれている という形式の IDictionary エントリをプロパティが保持する 1 つの例外に統合されます。 エントリを列挙するには、 を使用 For…Each します。
次の表に、 メソッドに関連するタスクの例を My.Computer.FileSystem.CopyDirectory 示します。
| 終了 | 解決方法については、 |
|---|---|
| ディレクトリをコピーする | 方法: ディレクトリを別のディレクトリにコピーする |
こちらもご覧ください
- UICancelOption
- オブジェクト (Visual Basic)
- 方法: Visual Basic でディレクトリにあるファイルのコレクションを取得する
- 方法 : Visual Basic でファイル パスを解析する
適用対象
CopyDirectory(String, String, UIOption)
あるディレクトリを別のディレクトリにコピーします。
public:
void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI);public void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI);member this.CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unitPublic Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption)パラメーター
- sourceDirectoryName
- String
コピーするディレクトリ。
- destinationDirectoryName
- String
ディレクトリのコピー先の場所。
- showUI
- UIOption
操作の進行状況を視覚的に追跡するかどうか。 既定値は UIOption.OnlyErrorDialogs です。
例外
パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。または、デバイス パスです (\\.\で始まります)。
destinationDirectoryName または sourceDirectoryName が Nothing または空の文字列です。
コピー元のディレクトリが存在しません。
コピー元とコピー先のパスが同じです。
操作が巡回しています。
パスがシステム定義の最大長を超えています。
パス内のフォルダー名にコロン (:) が含まれているか、形式が無効です。
ユーザーがパスを参照するのに必要なアクセス許可を保持していません。
コピー先のファイルは存在しますが、アクセスできません。
ShowUI が UIOption.AllDialogs に設定されている場合にユーザーが操作を取り消したか、ディレクトリ内の 1 つ以上のファイルをコピーできません。
例
次の例では、 ディレクトリを にTestDirectory2コピーし、既存のファイルを上書きしますTestDirectory1。
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
と C:\TestDirectory2 を、コピーするディレクトリのパスと名前、およびコピー先の場所に置き換えますC:\TestDirectory1。
注釈
このメソッドでは、ディレクトリ自体とその内容がコピーされます。 ターゲット ディレクトリが存在しない場合は、作成されます。 ターゲットの場所に同じ名前のディレクトリが存在する場合、2 つのディレクトリの内容がマージされます。 操作中に、ディレクトリに新しい名前を指定できます。
ディレクトリ内のファイルをコピーするときに、特定のファイルによって発生する例外がスローされる場合があります。 このような例外がスローされると、ファイルまたはディレクトリ パスがキーであり、特定の例外 Data メッセージが対応する値に含まれている という形式の IDictionary エントリをプロパティが保持する 1 つの例外に統合されます。 エントリを列挙するには、 を使用 For…Each します。
次の表に、 メソッドに関連するタスクの例を My.Computer.FileSystem.CopyDirectory 示します。
| 終了 | 解決方法については、 |
|---|---|
| ディレクトリをコピーする | 方法: ディレクトリを別のディレクトリにコピーする |
こちらもご覧ください
- UICancelOption
- オブジェクト (Visual Basic)
- 方法: Visual Basic でディレクトリにあるファイルのコレクションを取得する
- 方法 : Visual Basic でファイル パスを解析する
適用対象
CopyDirectory(String, String, Boolean)
あるディレクトリを別のディレクトリにコピーします。
public:
void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, bool overwrite);public void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, bool overwrite);member this.CopyDirectory : string * string * bool -> unitPublic Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, overwrite As Boolean)パラメーター
- sourceDirectoryName
- String
コピーするディレクトリ。
- destinationDirectoryName
- String
ディレクトリのコピー先の場所。
- overwrite
- Boolean
既存のファイルを上書きする場合は True。それ以外の場合は False。 既定値は False です。
例外
パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。または、デバイス パスです (\\.\で始まります)。
destinationDirectoryName または sourceDirectoryName が Nothing または空の文字列です。
コピー元のディレクトリが存在しません。
コピー元とコピー先のパスが同じです。
操作が巡回しています。
パスがシステム定義の最大長を超えています。
パス内のフォルダー名にコロン (:) が含まれているか、形式が無効です。
ユーザーがパスを参照するのに必要なアクセス許可を保持していません。
コピー先のファイルは存在しますが、アクセスできません。
例
次の例では、 ディレクトリを にTestDirectory2コピーし、既存のファイルを上書きしますTestDirectory1。
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
と C:\TestDirectory2 を、コピーするディレクトリのパスと名前、およびコピー先の場所に置き換えますC:\TestDirectory1。
注釈
このメソッドでは、ディレクトリ自体とその内容がコピーされます。 ターゲット ディレクトリが存在しない場合は、作成されます。 ターゲットの場所に同じ名前のディレクトリが存在する場合、2 つのディレクトリの内容がマージされます。 操作中に、ディレクトリに新しい名前を指定できます。
ディレクトリ内のファイルをコピーするときに、 が にFalse設定されている間overwriteにマージ中に存在するファイルなど、特定のファイルによって発生する例外がスローされる場合があります。 このような例外がスローされると、ファイルまたはディレクトリ パスがキーであり、特定の例外 Data メッセージが対応する値に含まれている という形式の IDictionary エントリをプロパティが保持する 1 つの例外に統合されます。 エントリを列挙するには、 を使用 For…Each します。
次の表に、 メソッドに関連するタスクの例を My.Computer.FileSystem.CopyDirectory 示します。
| 終了 | 解決方法については、 |
|---|---|
| ディレクトリをコピーする | 方法: ディレクトリを別のディレクトリにコピーする |
こちらもご覧ください
- UICancelOption
- オブジェクト (Visual Basic)
- 方法: Visual Basic でディレクトリにあるファイルのコレクションを取得する
- 方法 : Visual Basic でファイル パスを解析する
適用対象
CopyDirectory(String, String, UIOption, UICancelOption)
あるディレクトリを別のディレクトリにコピーします。
public:
void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);member this.CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption, onUserCancel As UICancelOption)パラメーター
- sourceDirectoryName
- String
コピーするディレクトリ。
- destinationDirectoryName
- String
ディレクトリのコピー先の場所。
- showUI
- UIOption
操作の進行状況を視覚的に追跡するかどうか。 既定値は UIOption.OnlyErrorDialogs です。
- onUserCancel
- UICancelOption
操作中にユーザーが [キャンセル] をクリックした場合の処理を指定します。 既定値は ThrowException です。
例外
パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。または、デバイス パスです (\\.\で始まります)。
destinationDirectoryName または sourceDirectoryName が Nothing または空の文字列です。
コピー元のディレクトリが存在しません。
コピー元とコピー先のパスが同じです。
操作が巡回しています。
パスがシステム定義の最大長を超えています。
パス内のフォルダー名にコロン (:) が含まれているか、形式が無効です。
ユーザーがパスを参照するのに必要なアクセス許可を保持していません。
コピー先のファイルは存在しますが、アクセスできません。
ShowUI が UIOption.AllDialogs に設定されている場合にユーザーが操作を取り消したか、ディレクトリ内の 1 つ以上のファイルをコピーできません。
例
次の例では、 ディレクトリを にTestDirectory2コピーし、既存のファイルを上書きしますTestDirectory1。
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
と C:\TestDirectory2 を、コピーするディレクトリのパスと名前、およびコピー先の場所に置き換えますC:\TestDirectory1。
注釈
このメソッドでは、ディレクトリ自体とその内容がコピーされます。 ターゲット ディレクトリが存在しない場合は、作成されます。 ターゲットの場所に同じ名前のディレクトリが存在する場合、2 つのディレクトリの内容がマージされます。 操作中に、ディレクトリに新しい名前を指定できます。
ディレクトリ内のファイルをコピーするときに、特定のファイルによって発生する例外がスローされる場合があります。 このような例外がスローされると、ファイルまたはディレクトリ パスがキーであり、特定の例外 Data メッセージが対応する値に含まれている という形式の IDictionary エントリをプロパティが保持する 1 つの例外に統合されます。 エントリを列挙するには、 を使用 For…Each します。
次の表に、 メソッドに関連するタスクの例を My.Computer.FileSystem.CopyDirectory 示します。
| 終了 | 解決方法については、 |
|---|---|
| ディレクトリをコピーする | 方法: ディレクトリを別のディレクトリにコピーする |
こちらもご覧ください
- UICancelOption
- オブジェクト (Visual Basic)
- 方法: Visual Basic でディレクトリにあるファイルのコレクションを取得する
- 方法 : Visual Basic でファイル パスを解析する
適用対象
.NET
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示