FileSystem.CopyDirectory メソッド

定義

ディレクトリの内容を別のディレクトリにコピーします。

オーバーロード

CopyDirectory(String, String)

ディレクトリの内容を別のディレクトリにコピーします。

CopyDirectory(String, String, UIOption)

ディレクトリの内容を別のディレクトリにコピーします。

CopyDirectory(String, String, Boolean)

ディレクトリの内容を別のディレクトリにコピーします。

CopyDirectory(String, String, UIOption, UICancelOption)

ディレクトリの内容を別のディレクトリにコピーします。

CopyDirectory(String, String)

ディレクトリの内容を別のディレクトリにコピーします。

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName);
public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName);
static member CopyDirectory : string * string -> unit
Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String)

パラメーター

sourceDirectoryName
String

コピーするディレクトリ。

destinationDirectoryName
String

ディレクトリの内容のコピー先の場所。

例外

パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。または、デバイス パスです (\\.\で始まります)。

destinationDirectoryName または sourceDirectoryNameNothing または空の文字列です。

コピー元のディレクトリが存在しません。

コピー元とコピー先のパスが同じです。

操作が巡回しています。

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

パス内のフォルダー名にコロン (:) が含まれているか、形式が無効です。

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

コピー先のファイルは存在しますが、アクセスできません。

次の例では、ディレクトリの内容を に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)

ディレクトリの内容を別のディレクトリにコピーします。

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 -> unit
Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption)

パラメーター

sourceDirectoryName
String

コピーするディレクトリ。

destinationDirectoryName
String

ディレクトリの内容のコピー先の場所。

showUI
UIOption

操作の進行状況を視覚的に追跡するかどうか。 既定値は UIOption.OnlyErrorDialogs です。

例外

パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。または、デバイス パスです (\\.\で始まります)。

destinationDirectoryName または sourceDirectoryNameNothing または空の文字列です。

コピー元のディレクトリが存在しません。

コピー元とコピー先のパスが同じです。

操作が巡回しています。

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

パス内のフォルダー名にコロン (:) が含まれているか、形式が無効です。

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

コピー先のファイルは存在しますが、アクセスできません。

ShowUIUIOption.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)

ディレクトリの内容を別のディレクトリにコピーします。

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 -> unit
Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, overwrite As Boolean)

パラメーター

sourceDirectoryName
String

コピーするディレクトリ。

destinationDirectoryName
String

ディレクトリの内容のコピー先の場所。

overwrite
Boolean

既存のファイルを上書きする場合は True。それ以外の場合は False。 既定値は False です。

例外

パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白だけが含まれています。無効な文字が含まれています。または、デバイス パスです (\\.\で始まります)。

destinationDirectoryName または sourceDirectoryNameNothing または空の文字列です。

コピー元のディレクトリが存在しません。

コピー元とコピー先のパスが同じです。

操作が巡回しています。

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

パス内のフォルダー名にコロン (:) が含まれているか、形式が無効です。

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

コピー先のファイルは存在しますが、アクセスできません。

次の例では、ディレクトリ 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)

ディレクトリの内容を別のディレクトリにコピーします。

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 -> unit
Public 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 または sourceDirectoryNameNothing または空の文字列です。

コピー元のディレクトリが存在しません。

コピー元とコピー先のパスが同じです。

操作が巡回しています。

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

パス内のフォルダー名にコロン (:) が含まれているか、形式が無効です。

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

コピー先のファイルは存在しますが、アクセスできません。

ShowUIUIOption.AllDialogs に設定されている場合にユーザーが操作を取り消したか、ディレクトリ内の 1 つ以上のファイルをコピーできません。

次の例では、ディレクトリ TestDirectory1 の内容を に TestDirectory2コピーし、進行状況ダイアログとエラー ダイアログを表示し、操作中にユーザーが [キャンセル ] をクリックした場合は何も行いません。

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", UIOption.AllDialogs, UICancelOption.DoNothing)

C:\TestDirectory2 を、コピーするディレクトリのパスと名前、およびコピー先の場所に置き換えますC:\TestDirectory1

注釈

このメソッドは、ソース ディレクトリの内容をターゲット ディレクトリにコピーします。 ターゲット ディレクトリが存在しない場合は、作成されます。 ターゲットの場所に同じ名前のディレクトリが存在する場合、2 つのディレクトリの内容がマージされます。 操作中に、ディレクトリに新しい名前を指定できます。

ディレクトリ内のファイルをコピーするときに、特定のファイルによって発生する例外がスローされる可能性があります。 このような例外がスローされると、ファイルまたはディレクトリ パスがキーであり、特定のIDictionary例外Dataメッセージが対応する値に含まれる という形式のエントリをプロパティが保持する 1 つの例外に統合されます。 を使用して For…Each 、エントリを列挙します。

次の表に、 メソッドを含むタスクの例を My.Computer.FileSystem.CopyDirectory 示します。

終了 解決方法については、
ディレクトリをコピーする 方法 : Visual Basic でディレクトリを別のディレクトリにコピーする

こちらもご覧ください

適用対象