FileSystem.RenameFile(String, String) メソッド

定義

名前空間:

Microsoft.VisualBasic.FileIO

アセンブリ:

Microsoft.VisualBasic.Core.dll

ソース:

FileSystem.vb

ファイル名を変更します。

public:
 static void RenameFile(System::String ^ file, System::String ^ newName);

public static void RenameFile (string file, string newName);

static member RenameFile : string * string -> unit

Public Shared Sub RenameFile (file As String, newName As String)

パラメーター

file

String

名前を変更するファイル。

newName

String

新しいファイル名。

例外

ArgumentException

newName にはパス情報が含まれているか、円記号 (\) で終わります。

ArgumentNullException

file は Nothing です。

- または -

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

FileNotFoundException

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

IOException

newName で指定したのと同じ名前のファイルまたはディレクトリが既に存在します。

PathTooLongException

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

NotSupportedException

パス内のファイル名またはディレクトリ名にコロン (:) が含まれているか、形式が無効です。

SecurityException

ユーザーがパスを参照するのに必要なアクセス許可を保持していません。

UnauthorizedAccessException

ユーザーに必要なアクセス許可がありません。

例

この例では、ファイル Test.txt の名前を に SecondTest.txt変更します。

My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")

"C:\Test.txt" を、名前を変更するファイルのパスとファイル名に変更します。

注釈

このメソッドは、ファイルを移動する目的には使用できません。ファイルを移動して名前を変更するには、MoveFile メソッドを使用してください。

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

終了	解決方法については、
ファイル名を変更する	方法 : Visual Basic でファイルの名前を変更する