FileSystemProxy.CopyDirectory メソッド

定義

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

オーバーロード

名前 説明
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

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

例外

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

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

ソース ディレクトリが存在しません。

ソース パスとターゲット パスは同じです。

操作は循環的です。

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

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

ユーザーには、パスを表示するために必要なアクセス許可がありません。

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

次の例では、ディレクトリ TestDirectory1TestDirectory2 にコピーし、既存のファイルを上書きします。

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)

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

注釈

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

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

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

ターゲット 参照先
ディレクトリをコピーする 方法: ディレクトリを別のディレクトリにコピーする

こちらもご覧ください

適用対象

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

例外

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

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

ソース ディレクトリが存在しません。

ソース パスとターゲット パスは同じです。

操作は循環的です。

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

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

ユーザーには、パスを表示するために必要なアクセス許可がありません。

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

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

次の例では、ディレクトリ TestDirectory1TestDirectory2 にコピーし、既存のファイルを上書きします。

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)

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

注釈

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

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

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

ターゲット 参照先
ディレクトリをコピーする 方法: ディレクトリを別のディレクトリにコピーする

こちらもご覧ください

適用対象

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

例外

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

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

ソース ディレクトリが存在しません。

ソース パスとターゲット パスは同じです。

操作は循環的です。

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

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

ユーザーには、パスを表示するために必要なアクセス許可がありません。

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

次の例では、ディレクトリ TestDirectory1TestDirectory2 にコピーし、既存のファイルを上書きします。

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)

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

注釈

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

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

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

ターゲット 参照先
ディレクトリをコピーする 方法: ディレクトリを別のディレクトリにコピーする

こちらもご覧ください

適用対象

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

例外

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

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

ソース ディレクトリが存在しません。

ソース パスとターゲット パスは同じです。

操作は循環的です。

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

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

ユーザーには、パスを表示するために必要なアクセス許可がありません。

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

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

次の例では、ディレクトリ TestDirectory1TestDirectory2 にコピーし、既存のファイルを上書きします。

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)

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

注釈

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

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

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

ターゲット 参照先
ディレクトリをコピーする 方法: ディレクトリを別のディレクトリにコピーする

こちらもご覧ください

適用対象