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

定義

名前空間:

Microsoft.VisualBasic.MyServices

アセンブリ:

Microsoft.VisualBasic.Forms.dll

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

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

public void RenameFile (string file, string newName);

member this.RenameFile : string * string -> unit

Public 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)
• Visual Basic でのファイルおよびディレクトリの作成、削除、および移動