FileSystemProxy.CopyDirectory メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ディレクトリを別のディレクトリにコピーします。
オーバーロード
| 名前 | 説明 |
|---|---|
| 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 または sourceDirectoryName が Nothing または空の文字列です。
ソース ディレクトリが存在しません。
ソース パスとターゲット パスは同じです。
操作は循環的です。
パスがシステム定義の最大長を超えています。
パス内のフォルダー名にコロン (:)または無効な形式が含まれています。
ユーザーには、パスを表示するために必要なアクセス許可がありません。
コピー先ファイルは存在しますが、アクセスできません。
例
次の例では、ディレクトリ TestDirectory1 を TestDirectory2 にコピーし、既存のファイルを上書きします。
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
C:\TestDirectory1とC:\TestDirectory2を、コピーするディレクトリのパスと名前、およびコピー先の場所に置き換えます。
注釈
このメソッドは、ディレクトリの内容とディレクトリ自体をコピーします。 ターゲット ディレクトリが存在しない場合は作成されます。 ターゲットの場所に同じ名前のディレクトリが存在する場合、2 つのディレクトリの内容がマージされます。 操作中にディレクトリの新しい名前を指定できます。
ディレクトリ内のファイルをコピーすると、特定のファイルによって発生する例外がスローされる可能性があります。 このような例外がスローされると、ファイルまたはディレクトリパスがキーであり、特定の例外メッセージが対応する値に含まれるIDictionaryの形式でエントリを保持するDataプロパティを持つ単一の例外に統合されます。
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 です。
例外
パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白のみを含みます。無効な文字が含まれています。または、デバイス パス (\\.\で始まる) です。
destinationDirectoryName または sourceDirectoryName が Nothing または空の文字列です。
ソース ディレクトリが存在しません。
ソース パスとターゲット パスは同じです。
操作は循環的です。
パスがシステム定義の最大長を超えています。
パス内のフォルダー名にコロン (:)または無効な形式が含まれています。
ユーザーには、パスを表示するために必要なアクセス許可がありません。
コピー先ファイルは存在しますが、アクセスできません。
ShowUI が UIOption.AllDialogs に設定され、ユーザーが操作を取り消すか、ディレクトリ内の 1 つ以上のファイルをコピーできません。
例
次の例では、ディレクトリ TestDirectory1 を TestDirectory2 にコピーし、既存のファイルを上書きします。
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
C:\TestDirectory1とC:\TestDirectory2を、コピーするディレクトリのパスと名前、およびコピー先の場所に置き換えます。
注釈
このメソッドは、ディレクトリの内容とディレクトリ自体をコピーします。 ターゲット ディレクトリが存在しない場合は作成されます。 ターゲットの場所に同じ名前のディレクトリが存在する場合、2 つのディレクトリの内容がマージされます。 操作中にディレクトリの新しい名前を指定できます。
ディレクトリ内のファイルをコピーすると、特定のファイルによって発生する例外がスローされる可能性があります。 このような例外がスローされると、ファイルまたはディレクトリパスがキーであり、特定の例外メッセージが対応する値に含まれるIDictionaryの形式でエントリを保持するDataプロパティを持つ単一の例外に統合されます。
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 です。
例外
パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白のみを含みます。無効な文字が含まれています。または、デバイス パス (\\.\で始まる) です。
destinationDirectoryName または sourceDirectoryName が Nothing または空の文字列です。
ソース ディレクトリが存在しません。
ソース パスとターゲット パスは同じです。
操作は循環的です。
パスがシステム定義の最大長を超えています。
パス内のフォルダー名にコロン (:)または無効な形式が含まれています。
ユーザーには、パスを表示するために必要なアクセス許可がありません。
コピー先ファイルは存在しますが、アクセスできません。
例
次の例では、ディレクトリ TestDirectory1 を TestDirectory2 にコピーし、既存のファイルを上書きします。
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
C:\TestDirectory1とC:\TestDirectory2を、コピーするディレクトリのパスと名前、およびコピー先の場所に置き換えます。
注釈
このメソッドは、ディレクトリの内容とディレクトリ自体をコピーします。 ターゲット ディレクトリが存在しない場合は作成されます。 ターゲットの場所に同じ名前のディレクトリが存在する場合、2 つのディレクトリの内容がマージされます。 操作中にディレクトリの新しい名前を指定できます。
ディレクトリ内のファイルをコピーすると、 overwrite が False に設定されている間にマージ中に存在するファイルなど、特定のファイルによって発生する例外がスローされることがあります。 このような例外がスローされると、ファイルまたはディレクトリパスがキーであり、特定の例外メッセージが対応する値に含まれるIDictionaryの形式でエントリを保持するDataプロパティを持つ単一の例外に統合されます。
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 です。
例外
パスは、次のいずれかの理由で無効です。長さ 0 の文字列です。空白のみを含みます。無効な文字が含まれています。または、デバイス パス (\\.\で始まる) です。
destinationDirectoryName または sourceDirectoryName が Nothing または空の文字列です。
ソース ディレクトリが存在しません。
ソース パスとターゲット パスは同じです。
操作は循環的です。
パスがシステム定義の最大長を超えています。
パス内のフォルダー名にコロン (:)または無効な形式が含まれています。
ユーザーには、パスを表示するために必要なアクセス許可がありません。
コピー先ファイルは存在しますが、アクセスできません。
ShowUI が UIOption.AllDialogs に設定され、ユーザーが操作を取り消すか、ディレクトリ内の 1 つ以上のファイルをコピーできません。
例
次の例では、ディレクトリ TestDirectory1 を TestDirectory2 にコピーし、既存のファイルを上書きします。
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
C:\TestDirectory1とC:\TestDirectory2を、コピーするディレクトリのパスと名前、およびコピー先の場所に置き換えます。
注釈
このメソッドは、ディレクトリの内容とディレクトリ自体をコピーします。 ターゲット ディレクトリが存在しない場合は作成されます。 ターゲットの場所に同じ名前のディレクトリが存在する場合、2 つのディレクトリの内容がマージされます。 操作中にディレクトリの新しい名前を指定できます。
ディレクトリ内のファイルをコピーすると、特定のファイルによって発生する例外がスローされる可能性があります。 このような例外がスローされると、ファイルまたはディレクトリパスがキーであり、特定の例外メッセージが対応する値に含まれるIDictionaryの形式でエントリを保持するDataプロパティを持つ単一の例外に統合されます。
For…Eachを使用してエントリを列挙します。
次の表に、 My.Computer.FileSystem.CopyDirectory メソッドに関連するタスクの例を示します。
| ターゲット | 参照先 |
|---|---|
| ディレクトリをコピーする | 方法: ディレクトリを別のディレクトリにコピーする |
こちらもご覧ください
- UICancelOption
- オブジェクト (Visual Basic)
方法: Visual Basic 方法: Visual Basic