My.Computer.FileSystem.MoveDirectory メソッド

[アーティクル]
09/30/2008

更新 : 2007 年 11 月

ディレクトリを別の場所に移動します。

' Usage
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,overwrite)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI ,onUserCancel)

' Declaration
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal showUI As UIOption _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal showUI As UIOption, _
   ByVal onUserCancel As UICancelOption _
)

パラメータ

sourceDirectoryName
String です。移動元のディレクトリのパスです。必ず指定します。
destinationDirectoryName
String です。移動先のディレクトリのパスです。必ず指定します。
overwrite
Boolean です。既存のディレクトリを上書きするかどうかを指定します。既定値は False です。必ず指定します。
showUI
UIOptionです。操作の進行状況を視覚的に表示するかどうかを指定します。既定値は UIOption.OnlyErrorDialogs です。必ず指定します。
onUserCancel
UICancelOption 列挙型です。ユーザーが操作をキャンセルしたときに例外をスローするかどうかを指定します。既定値は UICancelOption.ThrowException です。必ず指定します。

例外

次の条件を満たす場合は、例外が発生する可能性があります。

パスが長さ 0 の文字列である、パスに空白だけが含まれている、パスに無効な文字が含まれている、パスがデバイスパスである (\\.\ で始まる) (ArgumentException)。
パスが Nothing である (ArgumentNullException)。
パスが無効である (DirectoryNotFoundException)。
移動元のディレクトリがルートディレクトリである (IOException)。
組み合わせたパスが既存のファイルを指している (IOException)。
移動元のパスと移動先のパスが同じである (IOException)。
ファイルが既に存在していて、 overwrite が False に設定されている (IOException)。
onUserCancel が ThrowException に設定されていて、ファイルのサブディレクトリがコピーできない (IOException)。
操作が循環的である (InvalidOperationException)。
パス内のファイル名またはディレクトリ名にコロン (:) が含まれている (NotSupportedException)。
UICancelOption が ThrowException に設定されていて、ユーザーが操作をキャンセルしたか、操作が完了できなかった (OperationCanceledException)。
パスがシステムで定義されている最大長を超えている (PathTooLongException)。
UICancelOption が ThrowException に設定されていて、ユーザーが必要なアクセス許可を持っていない (SecurityException)。
ユーザーがファイルの修正に必要なアクセス許可を持っていない (UnauthorizedAccessException)。

解説

存在しないディレクトリの中にディレクトリを移動しようとした場合には、移動先の構造が自動的に作成されます。

処理手順

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

目的	参照項目
ディレクトリを移動する	方法 : Visual Basic でディレクトリを移動する

使用例

この例では、 Directory1 を Directory2 に移動します。

My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2")

この例では、 Directory1 を Directory2 に移動し、既に移動先が存在する場合はそのディレクトリを上書きします。

My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2", _
True)

必要条件

名前空間 : Microsoft.VisualBasic.MyServices

クラス : FileSystemProxy (FileSystem へのアクセスを可能にします)

アセンブリ : Visual Basic ランタイムライブラリ (Microsoft.VisualBasic.dll 内)

プロジェクトの種類ごとの可用性

プロジェクトの種類	可用性
Windows アプリケーション	可
クラスライブラリ	可
コンソールアプリケーション	可
Windows コントロールライブラリ	可
Web コントロールライブラリ	可
Windows サービス	可
Web サイト	可

アクセス許可

次のアクセス許可が必要です。

アクセス許可	説明
FileIOPermission	ファイルとフォルダへのアクセス許可を制御します。関連する列挙値 : Unrestricted。
UIPermission	ユーザーインターフェイスとクリップボードに関係するアクセス許可を制御します。関連する列挙値 : SafeSubWindows。