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 destinationFileName parametr nie była formą prawną.

-lub-

Ścieżka opisana przez destinationBackupFileName parametr nie była formą prawną.

ArgumentNullException

Parametr destinationFileName to null.

DriveNotFoundException

Określono nieprawidłowy dysk.

FileNotFoundException

Nie można odnaleźć pliku opisanego przez bieżący FileInfo obiekt.

-lub-

Nie można odnaleźć pliku opisanego destinationBackupFileName przez parametr .

IOException

Podczas otwierania pliku wystąpił błąd We/Wy.

-lub-

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

PathTooLongException

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

UnauthorizedAccessException

Parametr sourceFileName or 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 posiada wymaganych uprawnień.

-Lub

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

Przykłady

Poniższy przykład kodu używa Replace metody , 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 obiekt sourceFileName i destinationFileName znajdują się na różnych woluminach, ta metoda zgłosi wyjątek. Jeśli obiekt 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 zastępowanego pliku.

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

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 destinationFileName parametr nie była formą prawną.

-lub-

Ścieżka opisana przez destinationBackupFileName parametr nie była formą prawną.

ArgumentNullException

Parametr destinationFileName to null.

DriveNotFoundException

Określono nieprawidłowy dysk.

FileNotFoundException

Nie można odnaleźć pliku opisanego przez bieżący FileInfo obiekt.

-lub-

Nie można odnaleźć pliku opisanego destinationBackupFileName przez parametr .

IOException

Podczas otwierania pliku wystąpił błąd We/Wy.

-lub-

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

PathTooLongException

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

UnauthorizedAccessException

Parametr sourceFileName or 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 posiada wymaganych uprawnień.

-Lub

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

Przykłady

Poniższy przykład kodu używa Replace metody , 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 obiekt sourceFileName i destinationFileName znajdują się na różnych woluminach, ta metoda zgłosi wyjątek. Jeśli obiekt 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 zastępowanego pliku.

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

Dotyczy