FileSystem.Rename メソッド

.NET Framework クラス ライブラリ リファレンス

FileSystem.Rename メソッド

ディスク ファイルまたはディレクトリの名前を変更します。My 機能を使用すると、Rename を使用した場合よりファイル I/O 操作の生産性とパフォーマンスが向上します。詳細については、「My.Computer.FileSystem オブジェクト」を参照してください。

名前空間: Microsoft.VisualBasic
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub Rename
 ( _
    OldPath As String, _
    NewPath As String _
)

Visual Basic (使用法)

Dim OldPath As String
Dim NewPath As String

FileSystem.Rename(OldPath, NewPath)

C#

public static void Rename
 (
    string OldPath,
    string NewPath
)

C++

public:
static void Rename (
    String^ OldPath, 
    String^ NewPath
)

J#

public static void Rename
 (
    String OldPath, 
    String NewPath
)

JScript

public static function Rename
 (
    OldPath : String, 
    NewPath : String
)

パラメータ

OldPath

必須。既存のファイルの名前と場所を指定する String 式。OldPath には、ファイルのディレクトリおよびドライブを含めることができます。

NewPath

必須。新しいファイルの名前と場所を指定する String 型の式。NewPath には、出力先のディレクトリおよびドライブを含めることができます。NewPath には、既に存在しているファイル名は指定できません。

解説

詳細については、Visual Basic のトピック「Rename 関数」を参照してください。

Rename 関数は、ファイルの名前を変更し、必要に応じて別のディレクトリに移動します。Rename 関数は、ドライブ間でファイルを移動させますが、NewPath および OldPath が両方とも同じドライブにある場合は、既存のディレクトリ名を変更するだけです。Rename では、新しいファイルまたはディレクトリを作成できません。

開かれたファイルで Rename 関数を使用すると、エラーが発生します。名前を変更する前に開いたファイルを閉じる必要があります。 Rename 引数には、複数文字 (*) および単一文字 (?) のワイルドカードを含めることはできません。

セキュリティに関するメモ
Rename を使用して、保護されていない場所から保護された場所にファイルをコピーすると、ファイルは制限の少ない方の権限を保持することになります。セキュリティ リスクの可能性を大きくしないように注意してください。

使用例

この例では、Rename 関数を使用してファイルの名前を変更します。この例の目的に応じて、指定されたディレクトリは既に存在していると仮定します。

Visual Basic

Dim OldName, NewName As String
OldName = "OLDFILE"
' Define file names.
NewName = "NEWFILE"
' Rename file.
Rename(OldName, NewName)

OldName = "C:\OLDDIR\OLDFILE"
NewName = "C:\NEWDIR\NEWFILE"
' Move and rename file.
Rename(OldName, NewName)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
FileSystem クラス
FileSystem メンバ
Microsoft.VisualBasic 名前空間
ArgumentException Class
FileNotFoundException Class
IOException Class
その他の技術情報
Rename 関数
Kill 関数
方法 : Visual Basic でファイルの名前を変更する
方法 : Visual Basic でディレクトリの名前を変更する