File.Replace メソッド

定義

指定したファイルの内容を別のファイルの内容に置き換え、元のファイルを削除し、置き換えられたファイルのバックアップを作成します。

オーバーロード

Replace(String, String, String)

指定したファイルの内容を別のファイルの内容に置き換え、元のファイルを削除し、置き換えられたファイルのバックアップを作成します。

Replace(String, String, String, Boolean)

指定したファイルの内容を別のファイルの内容に置き換え、元のファイルを削除し、置き換えられたファイルのバックアップを作成し、必要に応じてマージ エラーを無視します。

注釈

Replace メソッドは、指定したファイルの内容を別のファイルの内容に置き換えます。 また、置き換えられたファイルのバックアップも作成します。

Replace(String, String, String)

ソース:
File.cs
ソース:
File.cs
ソース:
File.cs

指定したファイルの内容を別のファイルの内容に置き換え、元のファイルを削除し、置き換えられたファイルのバックアップを作成します。

public:
 static void Replace(System::String ^ sourceFileName, System::String ^ destinationFileName, System::String ^ destinationBackupFileName);
public static void Replace (string sourceFileName, string destinationFileName, string? destinationBackupFileName);
public static void Replace (string sourceFileName, string destinationFileName, string destinationBackupFileName);
static member Replace : string * string * string -> unit
Public Shared Sub Replace (sourceFileName As String, destinationFileName As String, destinationBackupFileName As String)

パラメーター

sourceFileName
String

destinationFileNameで指定されたファイルを置き換えるファイルの名前。

destinationFileName
String

置き換えられるファイルの名前。

destinationBackupFileName
String

バックアップ ファイルの名前。

例外

destinationFileName または destinationBackupFileName パラメーターによって記述されるパスは、有効な形式ではありません。

destinationFileName パラメーターは nullです。

無効なドライブが指定されました。

sourceFileName または destinationFileName パラメーターによって記述されたファイルが見つかりませんでした。

ファイルを開くときに I/O エラーが発生しました。

-又は-

sourceFileName パラメーターと destinationFileName パラメーターは、同じファイルを指定します。

指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。

sourceFileName または destinationFileName パラメーターは、読み取り専用のファイルを指定します。

-又は-

この操作は、現在のプラットフォームではサポートされていません。

-又は-

ソースパラメーターまたはコピー先パラメーターでは、ファイルの代わりにディレクトリを指定します。

-又は-

呼び出し元に必要なアクセス許可がありません。

-又は

sourceFileName し、同じ既存のディレクトリを指定 destinationFileName

次のコード例では、Replace メソッドを使用してファイルを別のファイルに置き換え、置き換えられたファイルのバックアップを作成します。

using namespace System;
using namespace System::IO;


// Move a file into another file, delete the original,
// and create a backup of the replaced file.

void ReplaceFile(String^ fileToMoveAndDelete,
                 String^ fileToReplace, String^ backupOfFileToReplace)
{
    File::Replace(fileToMoveAndDelete, fileToReplace,
        backupOfFileToReplace, false);
}	


int main()
{
    try
    {
        String^ originalFile = "test.xml";
        String^ fileToReplace = "test2.xml";
        String^ backUpOfFileToReplace = "test2.xml.bac";

        Console::WriteLine("Move the contents of " + originalFile + " into " 
            + fileToReplace + ", delete " + originalFile
            + ", and create a backup of " + fileToReplace + ".");

        // Replace the file.
        ReplaceFile(originalFile, fileToReplace, backUpOfFileToReplace);

        Console::WriteLine("Done");
    }
    catch (IOException^ ex)
    {
        Console::WriteLine(ex->Message);
    } 
};
using System;
using System.IO;

namespace FileSystemExample
{
    class FileExample
    {
        public static void Main()
        {
            try
            {
                string OriginalFile = "test.xml";
                string FileToReplace = "test2.xml";
                string BackUpOfFileToReplace = "test2.xml.bac";

                Console.WriteLine("Move the contents of " + OriginalFile + " into " + FileToReplace + ", delete " + OriginalFile +
                                   ", and create a backup of " + FileToReplace + ".");

                // Replace the file.
                ReplaceFile(OriginalFile, FileToReplace, BackUpOfFileToReplace);

                Console.WriteLine("Done");
            }
            catch (Exception e)
            {
                Console.WriteLine(e);
            }

            Console.ReadLine();
        }

        // Move a file into another file, delete the original, and create a backup of the replaced file.
        public static void ReplaceFile(string FileToMoveAndDelete, string FileToReplace, string BackupOfFileToReplace)
        {
            File.Replace(FileToMoveAndDelete, FileToReplace, BackupOfFileToReplace, false);
        }
    }
}
open System
open System.IO

// Move a file into another file, delete the original, and create a backup of the replaced file.
let replaceFile fileToMoveAndDelete fileToReplace backupOfFileToReplace =
    File.Replace(fileToMoveAndDelete, fileToReplace, backupOfFileToReplace, false)

let originalFile = "test.xml"
let fileToReplace = "test2.xml"
let backUpOfFileToReplace = "test2.xml.bac"

printfn
    $"Move the contents of {originalFile} into {fileToReplace}, delete {originalFile}, and create a backup of {fileToReplace}."

// Replace the file.
replaceFile originalFile fileToReplace backUpOfFileToReplace

printfn "Done"
Imports System.IO

Module FileExample

    Sub Main()
        Try
            Dim OriginalFile As String = "test.xml"
            Dim FileToReplace As String = "test2.xml"
            Dim BackUpOfFileToReplace As String = "test2.xml.bac"

            Console.WriteLine("Move the contents of " + OriginalFile + " into " + FileToReplace + ", delete " + OriginalFile + ", and create a backup of " + FileToReplace + ".")

            ' Replace the file.
            ReplaceFile(OriginalFile, FileToReplace, BackUpOfFileToReplace)

            Console.WriteLine("Done")
        Catch e As Exception
            Console.WriteLine(e)
        End Try

        Console.ReadLine()

    End Sub

    ' Move a file into another file, delete the original, and create a backup of the replaced file.
    Sub ReplaceFile(ByVal FileToMoveAndDelete As String, ByVal FileToReplace As String, ByVal BackupOfFileToReplace As String)

        ' Replace the file.
        File.Replace(FileToMoveAndDelete, FileToReplace, BackupOfFileToReplace, False)

    End Sub
End Module

注釈

Replace メソッドは、指定したファイルの内容を別のファイルの内容に置き換えます。 また、置き換えられたファイルのバックアップも作成されます。

sourceFileNamedestinationFileName が異なるボリュームにある場合、このメソッドは例外を発生させます。 destinationBackupFileName がソース ファイルとは異なるボリュームにある場合、バックアップ ファイルは削除されます。

置き換えられるファイルのバックアップを作成しない場合は、nulldestinationBackupFileName パラメーターに渡します。

destinationBackupFileName が既に存在する場合は、destinationFileName ファイルの内容に置き換えられます。

適用対象

Replace(String, String, String, Boolean)

ソース:
File.cs
ソース:
File.cs
ソース:
File.cs

指定したファイルの内容を別のファイルの内容に置き換え、元のファイルを削除し、置き換えられたファイルのバックアップを作成し、必要に応じてマージ エラーを無視します。

public:
 static void Replace(System::String ^ sourceFileName, System::String ^ destinationFileName, System::String ^ destinationBackupFileName, bool ignoreMetadataErrors);
public static void Replace (string sourceFileName, string destinationFileName, string? destinationBackupFileName, bool ignoreMetadataErrors);
public static void Replace (string sourceFileName, string destinationFileName, string destinationBackupFileName, bool ignoreMetadataErrors);
static member Replace : string * string * string * bool -> unit
Public Shared Sub Replace (sourceFileName As String, destinationFileName As String, destinationBackupFileName As String, ignoreMetadataErrors As Boolean)

パラメーター

sourceFileName
String

destinationFileNameで指定されたファイルを置き換えるファイルの名前。

destinationFileName
String

置き換えられるファイルの名前。

destinationBackupFileName
String

バックアップ ファイルの名前。

ignoreMetadataErrors
Boolean

置換されたファイルから置換ファイルへのマージ エラー (属性やアクセス制御リスト (ACL) など) を無視する true。それ以外の場合は、falseします。

例外

destinationFileName または destinationBackupFileName パラメーターによって記述されるパスは、有効な形式ではありません。

destinationFileName パラメーターは nullです。

無効なドライブが指定されました。

sourceFileName または destinationFileName パラメーターによって記述されたファイルが見つかりませんでした。

ファイルを開くときに I/O エラーが発生しました。

-又は-

sourceFileName し、同じファイル destinationFileName 指定します。

指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。

sourceFileName または destinationFileName パラメーターは、読み取り専用のファイルを指定します。

-又は-

この操作は、現在のプラットフォームではサポートされていません。

-又は-

ソースパラメーターまたはコピー先パラメーターでは、ファイルの代わりにディレクトリを指定します。

-又は-

呼び出し元に必要なアクセス許可がありません。

-又は

sourceFileName し、同じ既存のディレクトリを指定 destinationFileName

次のコード例では、Replace メソッドを使用してファイルを別のファイルに置き換え、置き換えられたファイルのバックアップを作成します。

using namespace System;
using namespace System::IO;


// Move a file into another file, delete the original,
// and create a backup of the replaced file.

void ReplaceFile(String^ fileToMoveAndDelete,
                 String^ fileToReplace, String^ backupOfFileToReplace)
{
    File::Replace(fileToMoveAndDelete, fileToReplace,
        backupOfFileToReplace, false);
}	


int main()
{
    try
    {
        String^ originalFile = "test.xml";
        String^ fileToReplace = "test2.xml";
        String^ backUpOfFileToReplace = "test2.xml.bac";

        Console::WriteLine("Move the contents of " + originalFile + " into " 
            + fileToReplace + ", delete " + originalFile
            + ", and create a backup of " + fileToReplace + ".");

        // Replace the file.
        ReplaceFile(originalFile, fileToReplace, backUpOfFileToReplace);

        Console::WriteLine("Done");
    }
    catch (IOException^ ex)
    {
        Console::WriteLine(ex->Message);
    } 
};
using System;
using System.IO;

namespace FileSystemExample
{
    class FileExample
    {
        public static void Main()
        {
            try
            {
                string OriginalFile = "test.xml";
                string FileToReplace = "test2.xml";
                string BackUpOfFileToReplace = "test2.xml.bac";

                Console.WriteLine("Move the contents of " + OriginalFile + " into " + FileToReplace + ", delete " + OriginalFile +
                                   ", and create a backup of " + FileToReplace + ".");

                // Replace the file.
                ReplaceFile(OriginalFile, FileToReplace, BackUpOfFileToReplace);

                Console.WriteLine("Done");
            }
            catch (Exception e)
            {
                Console.WriteLine(e);
            }

            Console.ReadLine();
        }

        // Move a file into another file, delete the original, and create a backup of the replaced file.
        public static void ReplaceFile(string FileToMoveAndDelete, string FileToReplace, string BackupOfFileToReplace)
        {
            File.Replace(FileToMoveAndDelete, FileToReplace, BackupOfFileToReplace, false);
        }
    }
}
open System
open System.IO

// Move a file into another file, delete the original, and create a backup of the replaced file.
let replaceFile fileToMoveAndDelete fileToReplace backupOfFileToReplace =
    File.Replace(fileToMoveAndDelete, fileToReplace, backupOfFileToReplace, false)

let originalFile = "test.xml"
let fileToReplace = "test2.xml"
let backUpOfFileToReplace = "test2.xml.bac"

printfn
    $"Move the contents of {originalFile} into {fileToReplace}, delete {originalFile}, and create a backup of {fileToReplace}."

// Replace the file.
replaceFile originalFile fileToReplace backUpOfFileToReplace

printfn "Done"
Imports System.IO

Module FileExample

    Sub Main()
        Try
            Dim OriginalFile As String = "test.xml"
            Dim FileToReplace As String = "test2.xml"
            Dim BackUpOfFileToReplace As String = "test2.xml.bac"

            Console.WriteLine("Move the contents of " + OriginalFile + " into " + FileToReplace + ", delete " + OriginalFile + ", and create a backup of " + FileToReplace + ".")

            ' Replace the file.
            ReplaceFile(OriginalFile, FileToReplace, BackUpOfFileToReplace)

            Console.WriteLine("Done")
        Catch e As Exception
            Console.WriteLine(e)
        End Try

        Console.ReadLine()

    End Sub

    ' Move a file into another file, delete the original, and create a backup of the replaced file.
    Sub ReplaceFile(ByVal FileToMoveAndDelete As String, ByVal FileToReplace As String, ByVal BackupOfFileToReplace As String)

        ' Replace the file.
        File.Replace(FileToMoveAndDelete, FileToReplace, BackupOfFileToReplace, False)

    End Sub
End Module

注釈

Replace メソッドは、指定したファイルの内容を別のファイルの内容に置き換えます。 また、置き換えられたファイルのバックアップも作成されます。

sourceFileNamedestinationFileName が異なるボリュームにある場合、このメソッドは例外を発生させます。 destinationBackupFileName がソース ファイルとは異なるボリュームにある場合、バックアップ ファイルは削除されます。

置き換えられるファイルのバックアップを作成しない場合は、nulldestinationBackupFileName パラメーターに渡します。

destinationBackupFileName が既に存在する場合は、destinationFileName ファイルの内容に置き換えられます。

適用対象