My.Computer.FileSystem.RenameDirectory メソッド
更新 : 2007 年 11 月
ディレクトリの名前を変更します。
' Usage
My.Computer.FileSystem.RenameDirectory(directory ,newName)
' Declaration
Public Sub RenameDirectory( _
ByVal directory As String, _
ByVal newName As String _
)
パラメータ
directory
名前を変更するディレクトリのパスと名前を指定する String です。必ず指定します。newName
ディレクトリの新しい名前を指定する String です。必ず指定します。
例外
次の条件を満たす場合は、例外が発生する可能性があります。
パスが無効です。1) 長さが 0 の文字列である、2) 空白だけが含まれている、3) 無効な文字が含まれている、4) デバイス パスである (\\.\ で開始されている)、のいずれかの理由が考えられます (ArgumentException)。
newName パラメータにパスの情報が指定されています (ArgumentException)。
パスが Nothing であるため、有効ではありません (ArgumentNullException)。
newName パラメータが Nothing または空の文字列です (ArgumentNullException)。
ソース ディレクトリが有効でないか存在しません (DirectoryNotFoundException)。
newName に指定された名前のファイルまたはディレクトリが既に存在します (IOException)。
ディレクトリがルート ディレクトリです (IOException)。
パスが 248 文字を超えています (PathTooLongException)。
パス内のファイル名またはディレクトリ名にコロン (:) が含まれているか、または形式が無効です (NotSupportedException)。
ユーザーがパスを表示するのに必要なアクセス許可を持っていません (SecurityException)。
ユーザーに必要なアクセス許可がありません (UnauthorizedAccessException)。
解説
このメソッドを使ってディレクトリを移動させることはできません。ディレクトリを移動して名前を変更するには、MoveDirectory を使用します。
処理手順
My.Computer.FileSystem.RenameDirectory メソッドに関連するタスクの例を次の表に示します。
目的 |
参照項目 |
|---|---|
ディレクトリの名前を変更します。 |
使用例
ディレクトリ名を Test から SecondTest に変換する例は次のようになります。
My.Computer.FileSystem.RenameDirectory("C:MyDocuments\Test", "SecondTest")
必要条件
名前空間 : Microsoft.VisualBasic.MyServices
クラス : FileSystemProxy (FileSystem へのアクセスを可能にします)
アセンブリ : Visual Basic ランタイム ライブラリ (Microsoft.VisualBasic.dll 内)
使用可能なプロジェクトの種類
プロジェクトの種類 |
使用可/不可 |
|---|---|
Windows アプリケーション |
可 |
クラス ライブラリ |
可 |
コンソール アプリケーション |
可 |
Windows コントロール ライブラリ |
可 |
Web コントロール ライブラリ |
可 |
Windows サービス |
可 |
Web サイト |
可 |
アクセス許可
次のアクセス許可が必要になる可能性があります。
アクセス許可 |
説明 |
|---|---|
ファイルとフォルダへのアクセス許可を制御します。関連する列挙値 : Unrestricted。 |
詳細については、「コード アクセス セキュリティ」および「アクセス許可の要求」を参照してください。
参照
処理手順
方法 : Visual Basic でファイル パスを解析する
参照
My.Computer.FileSystem.MoveDirectory メソッド