Udostępnij za pośrednictwem

File.Replace Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.IO
Zestaw:
System.IO.FileSystem.dll
Zestaw:
System.Runtime.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll

Zastępuje zawartość określonego pliku zawartością innego pliku, usuwając oryginalny plik i tworząc kopię zapasową zastąpionego pliku.

Przeciążenia

Replace(String, String, String)

Zastępuje zawartość określonego pliku zawartością innego pliku, usuwając oryginalny plik i tworząc kopię zapasową zastąpionego pliku.
Replace(String, String, String, Boolean)

Zastępuje zawartość określonego pliku zawartością innego pliku, usuwając oryginalny plik i tworząc kopię zapasową zastąpionego pliku, a opcjonalnie ignoruje błędy scalania.

Uwagi

Metody Replace zastępują zawartość określonego pliku zawartością innego pliku. Tworzą również kopię zapasową pliku, który został zastąpiony.

Replace(String, String, String)

Źródło:
File.cs
Źródło:
File.cs
Źródło:
File.cs

Zastępuje zawartość określonego pliku zawartością innego pliku, usuwając oryginalny plik i tworząc kopię zapasową zastąpionego pliku.

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)

Parametry

sourceFileName
String

Nazwa pliku, który zastępuje plik określony przez destinationFileName.

destinationFileName
String

Nazwa zastępowanego pliku.

destinationBackupFileName
String

Nazwa pliku kopii zapasowej.

Wyjątki

ArgumentException

Ścieżka opisana przez parametr destinationFileName lub destinationBackupFileName nie jest formą prawną.

ArgumentNullException

Parametr destinationFileName jest null.

DriveNotFoundException

Określono nieprawidłowy dysk.

FileNotFoundException

Nie można odnaleźć pliku opisanego przez sourceFileName lub parametru destinationFileName.

IOException

Wystąpił błąd we/wy podczas otwierania pliku.

-lub-

Parametry sourceFileName i destinationFileName określają ten sam plik.

PathTooLongException

Określona ścieżka, nazwa pliku lub obie metody przekraczają maksymalną długość zdefiniowaną przez system.

UnauthorizedAccessException

Parametr sourceFileName lub destinationFileName określa plik, który jest tylko do odczytu.

-lub-

Ta operacja nie jest obsługiwana na bieżącej platformie.

-lub-

Parametry źródłowe lub docelowe określają katalog zamiast pliku.

-lub-

Obiekt wywołujący nie ma wymaganych uprawnień.

-lub

sourceFileName i destinationFileName określić ten sam istniejący katalog.

Przykłady

W poniższym przykładzie kodu użyto metody Replace, aby zastąpić plik innym plikiem i utworzyć kopię zapasową zastąpionego pliku.

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

Uwagi

Metoda Replace zastępuje zawartość określonego pliku zawartością innego pliku. Tworzy również kopię zapasową pliku, który został zastąpiony.

Jeśli sourceFileName i destinationFileName znajdują się na różnych woluminach, ta metoda zgłasza wyjątek. Jeśli destinationBackupFileName znajduje się na innym woluminie niż plik źródłowy, plik kopii zapasowej zostanie usunięty.

Przekaż null do parametru destinationBackupFileName, jeśli nie chcesz tworzyć kopii zapasowej pliku, który jest zastępowany.

Jeśli destinationBackupFileName już istnieje, zostanie zastąpiony zawartością pliku destinationFileName.

Dotyczy

Replace(String, String, String, Boolean)

Źródło:
File.cs
Źródło:
File.cs
Źródło:
File.cs

Zastępuje zawartość określonego pliku zawartością innego pliku, usuwając oryginalny plik i tworząc kopię zapasową zastąpionego pliku, a opcjonalnie ignoruje błędy scalania.

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)

Parametry

sourceFileName
String

Nazwa pliku, który zastępuje plik określony przez destinationFileName.

destinationFileName
String

Nazwa zastępowanego pliku.

destinationBackupFileName
String

Nazwa pliku kopii zapasowej.

ignoreMetadataErrors
Boolean

true ignorować błędy scalania (takie jak atrybuty i listy kontroli dostępu )) z zastąpionego pliku do pliku zastępczego; w przeciwnym razie false.

Wyjątki

ArgumentException

Ścieżka opisana przez parametr destinationFileName lub destinationBackupFileName nie jest formą prawną.

ArgumentNullException

Parametr destinationFileName jest null.

DriveNotFoundException

Określono nieprawidłowy dysk.

FileNotFoundException

Nie można odnaleźć pliku opisanego przez sourceFileName lub parametru destinationFileName.

IOException

Wystąpił błąd we/wy podczas otwierania pliku.

-lub-

sourceFileName i destinationFileName określ ten sam plik.

PathTooLongException

Określona ścieżka, nazwa pliku lub obie metody przekraczają maksymalną długość zdefiniowaną przez system.

UnauthorizedAccessException

Parametr sourceFileName lub destinationFileName określa plik, który jest tylko do odczytu.

-lub-

Ta operacja nie jest obsługiwana na bieżącej platformie.

-lub-

Parametry źródłowe lub docelowe określają katalog zamiast pliku.

-lub-

Obiekt wywołujący nie ma wymaganych uprawnień.

-lub

sourceFileName i destinationFileName określić ten sam istniejący katalog.

Przykłady

W poniższym przykładzie kodu użyto metody Replace, aby zastąpić plik innym plikiem i utworzyć kopię zapasową zastąpionego pliku.

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

Uwagi

Metoda Replace zastępuje zawartość określonego pliku zawartością innego pliku. Tworzy również kopię zapasową pliku, który został zastąpiony.

Jeśli sourceFileName i destinationFileName znajdują się na różnych woluminach, ta metoda zgłasza wyjątek. Jeśli destinationBackupFileName znajduje się na innym woluminie niż plik źródłowy, plik kopii zapasowej zostanie usunięty.

Przekaż null do parametru destinationBackupFileName, jeśli nie chcesz tworzyć kopii zapasowej pliku, który jest zastępowany.

Jeśli destinationBackupFileName już istnieje, zostanie zastąpiony zawartością pliku destinationFileName.

Dotyczy