FileSystem.CopyDirectory メソッド

定義

名前空間:

Microsoft.VisualBasic.FileIO

アセンブリ:

Microsoft.VisualBasic.Core.dll

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

オーバーロード

CopyDirectory(String, String)	ディレクトリの内容を別のディレクトリにコピーします。
CopyDirectory(String, String, UIOption)	ディレクトリの内容を別のディレクトリにコピーします。
CopyDirectory(String, String, Boolean)	ディレクトリの内容を別のディレクトリにコピーします。
CopyDirectory(String, String, UIOption, UICancelOption)	ディレクトリの内容を別のディレクトリにコピーします。

CopyDirectory(String, String)

ソース:

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 -> unit

Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String)

パラメーター

sourceDirectoryName

String

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

destinationDirectoryName

String

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

例外

ArgumentException

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

ArgumentNullException

destinationDirectoryName または sourceDirectoryName が Nothing または空の文字列です。

DirectoryNotFoundException

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

IOException

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

InvalidOperationException

操作が巡回しています。

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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

例

次の例では、ディレクトリの内容を に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 でディレクトリを別のディレクトリにコピーする

こちらもご覧ください

• UICancelOption

CopyDirectory(String, String, UIOption)

ソース:

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 -> unit

Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption)

パラメーター

sourceDirectoryName

String

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

destinationDirectoryName

String

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

showUI

UIOption

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

例外

ArgumentException

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

ArgumentNullException

destinationDirectoryName または sourceDirectoryName が Nothing または空の文字列です。

DirectoryNotFoundException

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

IOException

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

InvalidOperationException

操作が巡回しています。

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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

OperationCanceledException

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 でディレクトリを別のディレクトリにコピーする

こちらもご覧ください

• UICancelOption

CopyDirectory(String, String, Boolean)

ソース:

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 -> unit

Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, overwrite As Boolean)

パラメーター

sourceDirectoryName

String

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

destinationDirectoryName

String

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

overwrite

Boolean

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

例外

ArgumentException

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

ArgumentNullException

destinationDirectoryName または sourceDirectoryName が Nothing または空の文字列です。

DirectoryNotFoundException

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

IOException

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

InvalidOperationException

操作が巡回しています。

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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

例

次の例では、ディレクトリ 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 でディレクトリを別のディレクトリにコピーする

こちらもご覧ください

• UICancelOption

CopyDirectory(String, String, UIOption, UICancelOption)

ソース:

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

例外

ArgumentException

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

ArgumentNullException

destinationDirectoryName または sourceDirectoryName が Nothing または空の文字列です。

DirectoryNotFoundException

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

IOException

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

InvalidOperationException

操作が巡回しています。

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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

OperationCanceledException

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 でディレクトリを別のディレクトリにコピーする

こちらもご覧ください

• UICancelOption