File.Move メソッド

[アーティクル]
03/28/2008

指定したファイルを新しい場所に移動します。オプションで新しいファイル名を指定することもできます。

Public Shared Sub Move( _
   ByVal sourceFileName As String, _   ByVal destFileName As String _)
[C#]
public static void Move(stringsourceFileName,stringdestFileName);
[C++]
public: static void Move(String* sourceFileName,String* destFileName);
[JScript]
public static function Move(
   sourceFileName : String,destFileName : String);

パラメータ

sourceFileName
移動するファイルの名前。
destFileName
ファイルの新しいパス。

例外

例外の種類	条件
IOException	移動先のファイルは既に存在します。
ArgumentNullException	sourceFileName または destFileName が null 参照 (Visual Basic では Nothing) です。
ArgumentException	sourceFileName または destFileName が、長さが 0 の文字列であるか、空白しか含んでいないか、 InvalidPathChars で定義されている無効な文字を含んでいます。
UnauthorizedAccessException	呼び出し元に、必要なアクセス許可がありません。
FileNotFoundException	sourceFileName は見つかりませんでした。
PathTooLongException	指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。
DirectoryNotFoundException	割り当てられていないドライブであるなど、 sourceFileName または destFileName で指定されたパスが無効です。
NotSupportedException	sourceFileName または destFileName の形式が無効です。

解説

このメソッドは、複数のディスクボリュームにわたって動作し、移動元と移動先が同じ場合は、例外をスローしません。

sourceFileName 引数および destFileName 引数は、相対パス情報または絶対パス情報を指定することを許可されています。相対パス情報は、現在の作業ディレクトリに対して相対的に解釈されます。現在の作業ディレクトリを取得するには、 GetCurrentDirectory のトピックを参照してください。

このメソッドの使用例については、以下の「使用例」を参照してください。その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルに書き込む。	ファイルへのテキストの書き込み
テキストファイルから読み取る。	ファイルからのテキストの読み取り
テキストをファイルに追加する。	ログファイルのオープンと追加 File.AppendText FileInfo.AppendText
ファイルをコピーする。	File.Copy FileInfo.CopyTo
ディレクトリの名前を変更、またはディレクトリを移動する。	Directory.Move DirectoryInfo.MoveTo

使用例

[Visual Basic, C#, C++] ファイルを移動する例を次に示します。

 
Imports System
Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        Dim path2 As String = path + "temp"

        Try
            If File.Exists(path) = False Then
                ' This statement ensures that the file is created,
                ' but the handle is not kept.
                Dim fs As FileStream = File.Create(path)
                fs.Close()
            End If

            ' Ensure that the target does not exist.
            If File.Exists(path2) Then
                File.Delete(path2)
            End If

            ' Move the file.
            File.Move(path, path2)
            Console.WriteLine("{0} moved to {1}", path, path2)

            ' See if the original file exists now.
            If File.Exists(path) Then
                Console.WriteLine("The original file still exists, which is unexpected.")
            Else
                Console.WriteLine("The original file no longer exists, which is expected.")
            End If
        Catch e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

[C#] 
using System;
using System.IO;

class Test 
{
    public static void Main() 
    {
        string path = @"c:\temp\MyTest.txt";
        string path2 = path + "temp";
        try 
        {
            if (!File.Exists(path)) 
            {
                // This statement ensures that the file is created,
                // but the handle is not kept.
                using (FileStream fs = File.Create(path)) {}
            }

            // Ensure that the target does not exist.
            if (File.Exists(path2))    
            File.Delete(path2);

            // Move the file.
            File.Move(path, path2);
            Console.WriteLine("{0} was moved to {1}.", path, path2);

            // See if the original exists now.
            if (File.Exists(path)) 
            {
                Console.WriteLine("The original file still exists, which is unexpected.");
            } 
            else 
            {
                Console.WriteLine("The original file no longer exists, which is expected.");
            }            

        } 
        catch (Exception e) 
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

[C++] 
#using <mscorlib.dll>

using namespace System;
using namespace System::IO;

int main() {
    String* path = S"c:\\temp\\MyTest.txt";
    String* path2 = String::Concat(path, S"temp");
    try {
        if (!File::Exists(path)) {
            // This statement ensures that the file is created,
            // but the handle is not kept.
            FileStream* fs = File::Create(path);
            if (fs) __try_cast<IDisposable*>(fs)->Dispose();
        }

        // Ensure that the target does not exist.
        if (File::Exists(path2))    
            File::Delete(path2);

        // Move the file.
        File::Move(path, path2);
        Console::WriteLine(S"{0} was moved to {1}.", path, path2);

        // See if the original exists now.
        if (File::Exists(path)) {
            Console::WriteLine(S"The original file still exists, which is unexpected.");
        } else {
            Console::WriteLine(S"The original file no longer exists, which is expected.");
        }            
    } catch (Exception* e) {
        Console::WriteLine(S"The process failed: {0}", e);
    }
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard

.NET Framework セキュリティ:

FileIOPermission 。 FileIOPermissionAccess.Read 、 FileIOPermissionAccess.Write (関連する列挙体)

参照

次の方法で共有

File.Move メソッド

パラメータ

例外

解説

使用例

必要条件

参照

その他のリソース