FileSystem.CopyDirectory メソッド

定義

名前空間:: Microsoft.VisualBasic.FileIO

アセンブリ:: Microsoft.VisualBasic.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

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

ディレクトリの内容をコピーする場所。

例外

ArgumentException

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

ArgumentNullException

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

DirectoryNotFoundException

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

IOException

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

InvalidOperationException

操作は循環的です。

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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

例

次の例では、ディレクトリ TestDirectory1 の内容を TestDirectory2 にコピーします。

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

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

注釈

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

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

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

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

こちらもご覧ください

UICancelOption

適用対象

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

例外

ArgumentException

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

注釈

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

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

こちらもご覧ください

UICancelOption

適用対象

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

例外

ArgumentException

ArgumentNullException

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

DirectoryNotFoundException

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

IOException

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

InvalidOperationException

操作は循環的です。

PathTooLongException

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

NotSupportedException

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

SecurityException

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

UnauthorizedAccessException

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

例

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

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

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

注釈

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

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

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

こちらもご覧ください

UICancelOption

適用対象

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

例外

ArgumentException

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

注釈

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

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

こちらもご覧ください

UICancelOption

適用対象

フィードバック

このページはお役に立ちましたか?