File.Replace 方法

定義

命名空間:: System.IO

組件:: netstandard.dll, System.Runtime.dll

組件:: netstandard.dll, System.IO.FileSystem.dll

組件:: netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll

組件:: System.IO.FileSystem.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將指定檔案的內容替換為另一個檔案的內容，刪除原始檔案並備份被替換的檔案。

多載

名稱	Description
Replace(String, String, String)	將指定檔案的內容替換為另一個檔案的內容，刪除原始檔案並備份被替換的檔案。
Replace(String, String, String, Boolean)	將指定檔案的內容替換為另一個檔案的內容，刪除原始檔案並備份被替換的檔案，並可選擇忽略合併錯誤。

備註

這些方法將 Replace 指定檔案的內容替換為另一個檔案的內容。他們也會備份被替換的檔案。

Replace(String, String, String)

來源:: File.cs

來源:: File.cs

來源:: 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 or destinationBackupFileName 參數描述的路徑並非法律形式。

ArgumentNullException

參數 destinationFileName 為 null。

DriveNotFoundException

指定了一個無效的磁碟機。

FileNotFoundException

找不到由或 sourceFileNamedestinationFileName 參數描述的檔案。

IOException

開啟檔案時發生 I/O 錯誤。

-或-

sourceFileName和destinationFileName參數都指定同一個檔案。

PathTooLongException

指定的路徑、檔名或兩者都超過系統定義的最大長度。

UnauthorizedAccessException

sourceFileName or destinationFileName 參數指定一個唯讀的檔案。

-或-

目前平臺不支援此作業。

-或-

來源或目的地參數指定目錄而非檔案。

-或-

來電者沒有所需的權限。

-或

sourceFileName 並 destinationFileName 指定相同的現有目錄。

範例

以下程式碼範例使用 Replace 替換檔案的方法，將檔案替換成另一個檔案並備份被替換檔案。

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

來源:: 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