FileSystem.CopyDirectory メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ディレクトリの内容を別のディレクトリにコピーします。
オーバーロード
| CopyDirectory(String, String) |
ディレクトリの内容を別のディレクトリにコピーします。 |
| CopyDirectory(String, String, UIOption) |
ディレクトリの内容を別のディレクトリにコピーします。 |
| CopyDirectory(String, String, Boolean) |
ディレクトリの内容を別のディレクトリにコピーします。 |
| CopyDirectory(String, String, UIOption, UICancelOption) |
ディレクトリの内容を別のディレクトリにコピーします。 |
CopyDirectory(String, String)
- ソース:
- FileSystem.vb
- ソース:
- FileSystem.vb
- ソース:
- FileSystem.vb
ディレクトリの内容を別のディレクトリにコピーします。
public:
static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName);public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName);static member CopyDirectory : string * string -> unitPublic Shared 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")
と C:\TestDirectory2 を、コピーするディレクトリのパスと名前、およびコピー先の場所に置き換えますC:\TestDirectory1。
注釈
このメソッドは、ソース ディレクトリの内容をターゲット ディレクトリにコピーします。 ターゲット ディレクトリが存在しない場合は、作成されます。 ターゲットの場所に同じ名前のディレクトリが存在する場合、2 つのディレクトリの内容がマージされます。 操作中に、ディレクトリに新しい名前を指定できます。
ディレクトリ内のファイルをコピーするときに、特定のファイルによって発生する例外がスローされる場合があります。 このような例外がスローされると、ファイルまたはディレクトリ パスがキーであり、特定の例外 Data メッセージが対応する値に含まれている という形式の IDictionary エントリをプロパティが保持する 1 つの例外に統合されます。 エントリを列挙するには、 を使用 For…Each します。
次の表に、 メソッドを含むタスクの例を My.Computer.FileSystem.CopyDirectory 示します。
| 終了 | 解決方法については、 |
|---|---|
| ディレクトリをコピーする | 方法 : Visual Basic でディレクトリを別のディレクトリにコピーする |
こちらもご覧ください
適用対象
CopyDirectory(String, String, UIOption)
- ソース:
- FileSystem.vb
- ソース:
- FileSystem.vb
- ソース:
- FileSystem.vb
ディレクトリの内容を別のディレクトリにコピーします。
public:
static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI);public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI);static member CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unitPublic Shared 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 つ以上のファイルをコピーできません。
例
次の例では、ディレクトリ TestDirectory1 の内容を にコピーし、 TestDirectory2進行状況ダイアログとエラー ダイアログを表示します。
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", UIOption.AllDialogs)
と C:\TestDirectory2 を、コピーするディレクトリのパスと名前、およびコピー先の場所に置き換えますC:\TestDirectory1。
注釈
このメソッドは、ソース ディレクトリの内容をターゲット ディレクトリにコピーします。 ターゲット ディレクトリが存在しない場合は、作成されます。 ターゲットの場所に同じ名前のディレクトリが存在する場合、2 つのディレクトリの内容がマージされます。 操作中に、ディレクトリに新しい名前を指定できます。
ディレクトリ内のファイルをコピーするときに、特定のファイルによって発生する例外がスローされる場合があります。 このような例外がスローされると、ファイルまたはディレクトリ パスがキーであり、特定の例外 Data メッセージが対応する値に含まれている という形式の IDictionary エントリをプロパティが保持する 1 つの例外に統合されます。 エントリを列挙するには、 を使用 For…Each します。
次の表に、 メソッドを含むタスクの例を My.Computer.FileSystem.CopyDirectory 示します。
| 終了 | 解決方法については、 |
|---|---|
| ディレクトリをコピーする | 方法 : Visual Basic でディレクトリを別のディレクトリにコピーする |
こちらもご覧ください
適用対象
CopyDirectory(String, String, Boolean)
- ソース:
- FileSystem.vb
- ソース:
- FileSystem.vb
- ソース:
- FileSystem.vb
ディレクトリの内容を別のディレクトリにコピーします。
public:
static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, bool overwrite);public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, bool overwrite);static member CopyDirectory : string * string * bool -> unitPublic Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, overwrite As Boolean)パラメーター
- sourceDirectoryName
- String
コピーするディレクトリ。
- destinationDirectoryName
- String
ディレクトリの内容のコピー先の場所。
- overwrite
- Boolean
既存のファイルを上書きする場合は True。それ以外の場合は False。 既定値は False です。
例外
パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。または、デバイス パスです (\\.\で始まります)。
destinationDirectoryName または sourceDirectoryName が Nothing または空の文字列です。
コピー元のディレクトリが存在しません。
コピー元とコピー先のパスが同じです。
操作が巡回しています。
パスがシステム定義の最大長を超えています。
パス内のフォルダー名にコロン (:) が含まれているか、形式が無効です。
ユーザーがパスを参照するのに必要なアクセス許可を保持していません。
コピー先のファイルは存在しますが、アクセスできません。
例
次の例では、ディレクトリ TestDirectory1 の内容を に TestDirectory2コピーし、既存のファイルを上書きします。
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 示します。
| 終了 | 解決方法については、 |
|---|---|
| ディレクトリをコピーする | 方法 : Visual Basic でディレクトリを別のディレクトリにコピーする |
こちらもご覧ください
適用対象
CopyDirectory(String, String, UIOption, UICancelOption)
- ソース:
- FileSystem.vb
- ソース:
- FileSystem.vb
- ソース:
- FileSystem.vb
ディレクトリの内容を別のディレクトリにコピーします。
public:
static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);static member CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Shared 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 つ以上のファイルをコピーできません。
例
次の例では、ディレクトリ TestDirectory1 の内容を に TestDirectory2コピーし、進行状況ダイアログとエラー ダイアログを表示し、操作中にユーザーが [キャンセル ] をクリックした場合は何も行いません。
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", UIOption.AllDialogs, UICancelOption.DoNothing)
と C:\TestDirectory2 を、コピーするディレクトリのパスと名前、およびコピー先の場所に置き換えますC:\TestDirectory1。
注釈
このメソッドは、ソース ディレクトリの内容をターゲット ディレクトリにコピーします。 ターゲット ディレクトリが存在しない場合は、作成されます。 ターゲットの場所に同じ名前のディレクトリが存在する場合、2 つのディレクトリの内容がマージされます。 操作中に、ディレクトリに新しい名前を指定できます。
ディレクトリ内のファイルをコピーするときに、特定のファイルによって発生する例外がスローされる場合があります。 このような例外がスローされると、ファイルまたはディレクトリ パスがキーであり、特定の例外 Data メッセージが対応する値に含まれている という形式の IDictionary エントリをプロパティが保持する 1 つの例外に統合されます。 エントリを列挙するには、 を使用 For…Each します。
次の表に、 メソッドを含むタスクの例を My.Computer.FileSystem.CopyDirectory 示します。
| 終了 | 解決方法については、 |
|---|---|
| ディレクトリをコピーする | 方法 : Visual Basic でディレクトリを別のディレクトリにコピーする |
