File.Replace メソッド

リファレンス

定義

名前空間:: System.IO

アセンブリ:: System.IO.FileSystem.dll

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

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

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

例外

ArgumentException

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

ArgumentNullException

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

DriveNotFoundException

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

FileNotFoundException

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

IOException

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

-又は-

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

PathTooLongException

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

UnauthorizedAccessException

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

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

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

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します。

例外

ArgumentException

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

ArgumentNullException

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

DriveNotFoundException

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

FileNotFoundException

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

IOException

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

-又は-

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

PathTooLongException

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

UnauthorizedAccessException

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

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

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

適用対象

次の方法で共有

File.Replace メソッド

定義

オーバーロード

注釈

Replace(String, String, String)

パラメーター

例外

例

注釈

適用対象

Replace(String, String, String, Boolean)

パラメーター

例外

例

注釈

適用対象

その他のリソース