Bagikan melalui

File.Replace Metode

  • Referensi

Definisi

Ruang nama:
System.IO
Rakitan:
System.IO.FileSystem.dll
Rakitan:
System.Runtime.dll
Rakitan:
mscorlib.dll
Rakitan:
netstandard.dll

Mengganti konten file tertentu dengan konten file lain, menghapus file asli dan membuat cadangan file yang diganti.

Overload

Replace(String, String, String)

Mengganti konten file tertentu dengan konten file lain, menghapus file asli dan membuat cadangan file yang diganti.
Replace(String, String, String, Boolean)

Mengganti konten file tertentu dengan konten file lain, menghapus file asli dan membuat cadangan file yang diganti, dan secara opsional mengabaikan kesalahan penggabungan.

Keterangan

Metode Replace menggantikan konten file tertentu dengan konten file lain. Mereka juga membuat cadangan file yang diganti.

Replace(String, String, String)

Sumber:
File.cs
Sumber:
File.cs
Sumber:
File.cs

Mengganti konten file tertentu dengan konten file lain, menghapus file asli dan membuat cadangan file yang diganti.

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)

Parameter

sourceFileName
String

Nama file yang menggantikan file yang ditentukan oleh destinationFileName.

destinationFileName
String

Nama file yang diganti.

destinationBackupFileName
String

Nama file cadangan.

Pengecualian

ArgumentException

Jalur yang dijelaskan oleh parameter destinationFileName atau destinationBackupFileName bukan bentuk hukum.

ArgumentNullException

Parameter destinationFileNamenull.

DriveNotFoundException

Kandar yang tidak valid ditentukan.

FileNotFoundException

File yang dijelaskan oleh parameter sourceFileName atau destinationFileName tidak dapat ditemukan.

IOException

Terjadi kesalahan I/O saat membuka file.

-atau-

Parameter sourceFileName dan destinationFileName menentukan file yang sama.

PathTooLongException

Jalur yang ditentukan, nama file, atau keduanya melebihi panjang maksimum yang ditentukan sistem.

UnauthorizedAccessException

Parameter sourceFileName atau destinationFileName menentukan file yang bersifat baca-saja.

-atau-

Operasi ini tidak didukung pada platform saat ini.

-atau-

Parameter sumber atau tujuan menentukan direktori alih-alih file.

-atau-

Pemanggil tidak memiliki izin yang diperlukan.

-atau

sourceFileName dan destinationFileName menentukan direktori yang sama yang ada.

Contoh

Contoh kode berikut menggunakan metode Replace untuk mengganti file dengan file lain dan membuat cadangan file yang diganti.

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

Keterangan

Metode Replace menggantikan konten file tertentu dengan konten file lain. Ini juga membuat cadangan file yang diganti.

Jika sourceFileName dan destinationFileName berada pada volume yang berbeda, metode ini menimbulkan pengecualian. Jika destinationBackupFileName berada pada volume yang berbeda dari file sumber, file cadangan akan dihapus.

Teruskan null ke parameter destinationBackupFileName jika Anda tidak ingin membuat cadangan file yang diganti.

Jika destinationBackupFileName sudah ada, destinationBackupFileName diganti dengan konten file destinationFileName.

Berlaku untuk

Replace(String, String, String, Boolean)

Sumber:
File.cs
Sumber:
File.cs
Sumber:
File.cs

Mengganti konten file tertentu dengan konten file lain, menghapus file asli dan membuat cadangan file yang diganti, dan secara opsional mengabaikan kesalahan penggabungan.

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)

Parameter

sourceFileName
String

Nama file yang menggantikan file yang ditentukan oleh destinationFileName.

destinationFileName
String

Nama file yang diganti.

destinationBackupFileName
String

Nama file cadangan.

ignoreMetadataErrors
Boolean

true untuk mengabaikan kesalahan penggabungan (seperti atribut dan daftar kontrol akses (ACL)) dari file yang diganti ke file pengganti; jika tidak, false.

Pengecualian

ArgumentException

Jalur yang dijelaskan oleh parameter destinationFileName atau destinationBackupFileName bukan bentuk hukum.

ArgumentNullException

Parameter destinationFileNamenull.

DriveNotFoundException

Kandar yang tidak valid ditentukan.

FileNotFoundException

File yang dijelaskan oleh parameter sourceFileName atau destinationFileName tidak dapat ditemukan.

IOException

Terjadi kesalahan I/O saat membuka file.

-atau-

sourceFileName dan destinationFileName menentukan file yang sama.

PathTooLongException

Jalur yang ditentukan, nama file, atau keduanya melebihi panjang maksimum yang ditentukan sistem.

UnauthorizedAccessException

Parameter sourceFileName atau destinationFileName menentukan file yang bersifat baca-saja.

-atau-

Operasi ini tidak didukung pada platform saat ini.

-atau-

Parameter sumber atau tujuan menentukan direktori alih-alih file.

-atau-

Pemanggil tidak memiliki izin yang diperlukan.

-atau

sourceFileName dan destinationFileName menentukan direktori yang sama yang ada.

Contoh

Contoh kode berikut menggunakan metode Replace untuk mengganti file dengan file lain dan membuat cadangan file yang diganti.

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

Keterangan

Metode Replace menggantikan konten file tertentu dengan konten file lain. Ini juga membuat cadangan file yang diganti.

Jika sourceFileName dan destinationFileName berada pada volume yang berbeda, metode ini menimbulkan pengecualian. Jika destinationBackupFileName berada pada volume yang berbeda dari file sumber, file cadangan akan dihapus.

Teruskan null ke parameter destinationBackupFileName jika Anda tidak ingin membuat cadangan file yang diganti.

Jika destinationBackupFileName sudah ada, destinationBackupFileName diganti dengan konten file destinationFileName.

Berlaku untuk