My.Computer.FileSystem.RenameFile メソッド

[アーティクル]
08/16/2008

更新 : 2007 年 11 月

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

' Usage
My.Computer.FileSystem.RenameFile(file ,newName)
' Declaration
Public Sub RenameFile( _
   ByVal file As String, _
   ByVal newName As String _
)

パラメータ

file
名前を変更するファイルを指定する String です。必ず指定します。
newName
新しいファイル名を指定する String です。必ず指定します。

例外

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

パスが無効です。1) 長さが 0 の文字列である、2) 空白だけが含まれている、3) 無効な文字が含まれている、4) デバイスパスである (\\.\ で開始されている)、のいずれかの理由が考えられます (ArgumentException)。
newName パラメータにパスの情報が含まれているか、または円記号 (\) で開始されています (ArgumentException)。
パスが Nothing であるため、有効ではありません (ArgumentNullException)。
newName パラメータが Nothing または空の文字列です (ArgumentNullException)。
ソースファイルが有効でないか存在しません (FileNotFoundException)。
newName に指定された名前のファイルまたはディレクトリが既に存在します (IOException)。
パスがシステムで定義されている最大長 (PathTooLongException) を超えています。
パス内のファイル名またはディレクトリ名にコロン (:) が含まれているか、または形式が無効です (NotSupportedException)。
ユーザーがパスを表示するのに必要なアクセス許可がありません (SecurityException)。
ユーザーに必要なアクセス許可がありません (UnauthorizedAccessException)。

解説

このメソッドを使ってファイルを移動することはできません。ファイルを移動して名前を変更するには、My.Computer.FileSystem.MoveFile メソッドを使用します。

処理手順

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

目的	参照項目
ファイル名の変更	方法 : Visual Basic でファイルの名前を変更する

使用例

ファイル名を Test.txt から SecondTest.txt に変換する例は次のようになります。

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

"C:\Test.txt" の部分は、名前を変更するファイルのパスと名前に置き換えてください。

必要条件

名前空間 : Microsoft.VisualBasic.MyServices

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

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

使用可能なプロジェクトの種類

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

アクセス許可

次のアクセス許可が必要になる可能性があります。

アクセス許可	説明
FileIOPermission	ファイルとフォルダへのアクセス許可を制御します。関連する列挙値 : Unrestricted。

詳細については、「コードアクセスセキュリティ」および「アクセス許可の要求」を参照してください。

参照

My.Computer.FileSystem オブジェクト

FileSystem.RenameFile

その他の技術情報

Visual Basic でのファイルおよびディレクトリの作成、削除、および移動

次の方法で共有