方法 : Visual Basic でディレクトリの名前を変更する

更新 : 2007 年 11 月

My.Computer.FileSystem オブジェクトの RenameDirectory メソッドを使用すると、ディレクトリの名前を変更できます。その際、ディレクトリの現在の場所と名前、およびディレクトリの新しい名前を指定します。このメソッドでは、ディレクトリを移動することはできません。ディレクトリを移動して名前を変更するには、MoveDirectory メソッドを使用します。

ディレクトリの名前を変更するには

  • My.Computer.FileSystem.RenameDirectory メソッドを使用してディレクトリの名前を変更します。次のコードは、Test ディレクトリの名前を SecondTest に変更します。

    My.Computer.FileSystem.RenameDirectory("C:MyDocuments\Test", _
    "SecondTest")
    

このコードの例は、IntelliSense コード スニペットとしても利用できます。コード スニペット ピッカーでは、この例は [ファイル システム - ドライブ、フォルダ、およびファイルの処理] にあります。詳細については、「方法 : コードにスニペットを挿入する (Visual Basic)」を参照してください。

堅牢性の高いプログラム

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

  • パスが無効である。1) 長さが 0 の文字列である、2) 空白だけが含まれている、3) 無効な文字が含まれている、4) デバイス パスである (\\.\ で開始されている)、のいずれかの理由が考えられる (ArgumentException)。

  • newName にパス情報が含まれている (ArgumentException)。

  • パスが Nothing であるため、有効でない (ArgumentNullException)。

  • newName が Nothing または空の文字列である (ArgumentNullException)。

  • 対象のディレクトリが有効でないか、または存在しない (DirectoryNotFoundException)。

  • newName で指定したのと同じ名前のファイルまたはフォルダが既に存在する (IOException)。

  • フォルダがルート フォルダである (IOException)。

  • パスがシステムで定義されている最大長を超えている (PathTooLongException)。

  • パス内のファイル名またはフォルダ名にコロン (:) が含まれているか、または形式が無効である (NotSupportedException)。

  • ユーザーがパスを参照するのに必要なアクセス許可がない (SecurityException)。

  • ユーザーに必要なアクセス許可がない (UnauthorizedAccessException)。

参照

処理手順

方法 : Visual Basic でディレクトリを別のディレクトリにコピーする

方法 : Visual Basic でファイル パスを解析する

方法 : Visual Basic でディレクトリを移動する

方法 : Visual Basic でディレクトリの内容を移動する

参照

My.Computer.FileSystem.RenameDirectory メソッド