FileSystemProxy.CopyDirectory メソッド

定義

名前空間:

Microsoft.VisualBasic.MyServices

アセンブリ:

Microsoft.VisualBasic.Forms.dll

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

オーバーロード

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

Public 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", 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 -> unit

Public 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 つ以上のファイルをコピーできません。

例

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

Public 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

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

例

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

Public 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 つ以上のファイルをコピーできません。

例

次の例では、 ディレクトリを に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 でファイル パスを解析する