File.Replace Metoda

Definice

Obor názvů:: System.IO

Sestavení:: netstandard.dll, System.Runtime.dll

Sestavení:: netstandard.dll, System.IO.FileSystem.dll

Sestavení:: netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll

Sestavení:: System.IO.FileSystem.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Nahradí obsah zadaného souboru obsahem jiného souboru, odstraní původní soubor a vytvoří zálohu nahrazeného souboru.

Přetížení

Name	Description
Replace(String, String, String)	Nahradí obsah zadaného souboru obsahem jiného souboru, odstraní původní soubor a vytvoří zálohu nahrazeného souboru.
Replace(String, String, String, Boolean)	Nahradí obsah zadaného souboru obsahem jiného souboru, odstraní původní soubor a vytvoří zálohu nahrazeného souboru a volitelně ignoruje chyby sloučení.

Poznámky

Metody Replace nahrazují obsah zadaného souboru obsahem jiného souboru. Vytvoří také zálohu souboru, který byl nahrazen.

Replace(String, String, String)

Zdroj:: File.cs

Zdroj:: File.cs

Zdroj:: File.cs

Zdroj:: File.cs

Zdroj:: File.cs

Nahradí obsah zadaného souboru obsahem jiného souboru, odstraní původní soubor a vytvoří zálohu nahrazeného souboru.

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

Název souboru, který nahrazuje soubor určený destinationFileName.

destinationFileName: String

Název souboru, který se nahrazuje.

destinationBackupFileName: String

Název záložního souboru.

Výjimky

ArgumentException

Cesta popsaná parametrem destinationFileNamedestinationBackupFileName není právní formou.

ArgumentNullException

Parametr destinationFileName je null.

DriveNotFoundException

Byla zadána neplatná jednotka.

FileNotFoundException

Soubor popsaný parametrem sourceFileName nebyl destinationFileName nalezen.

IOException

Při otevírání souboru došlo k vstupně-výstupní chybě.

nebo

Parametry sourceFileName a destinationFileName parametry určují stejný soubor.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

UnauthorizedAccessException

Parametr sourceFileName určuje destinationFileName soubor, který je jen pro čtení.

nebo

Tato operace není na aktuální platformě podporovaná.

nebo

Zdrojové nebo cílové parametry určují adresář místo souboru.

nebo

Volající nemá požadované oprávnění.

-nebo

sourceFileName a destinationFileName zadejte stejný existující adresář.

Příklady

Následující příklad kódu používá metodu Replace k nahrazení souboru jiným souborem a vytvoření zálohy nahrazeného souboru.

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

Poznámky

Metoda Replace nahradí obsah zadaného souboru obsahem jiného souboru. Vytvoří také zálohu souboru, který byl nahrazen.

Pokud jsou sourceFileName a destinationFileName jsou na různých svazcích, tato metoda vyvolá výjimku. Pokud je na destinationBackupFileName jiném svazku než zdrojový soubor, záložní soubor se odstraní.

Pokud nechcete vytvořit zálohu nahrazeného souboru, předejte null ho destinationBackupFileName parametru.

Pokud už soubor destinationBackupFileName existuje, nahradí se obsahem destinationFileName souboru.

Platí pro

Replace(String, String, String, Boolean)

Zdroj:: File.cs

Zdroj:: File.cs

Zdroj:: File.cs

Zdroj:: File.cs

Zdroj:: File.cs

Nahradí obsah zadaného souboru obsahem jiného souboru, odstraní původní soubor a vytvoří zálohu nahrazeného souboru a volitelně ignoruje chyby sloučení.

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

Název souboru, který nahrazuje soubor určený destinationFileName.

destinationFileName: String

Název souboru, který se nahrazuje.

destinationBackupFileName: String

Název záložního souboru.

ignoreMetadataErrors: Boolean

trueignorovat chyby sloučení (například atributy a seznamy řízení přístupu (ACL)) z nahrazeného souboru do náhradního souboru; v opačném případě . false

Výjimky

ArgumentException

Cesta popsaná parametrem destinationFileNamedestinationBackupFileName není právní formou.

ArgumentNullException

Parametr destinationFileName je null.

DriveNotFoundException

Byla zadána neplatná jednotka.

FileNotFoundException

Soubor popsaný parametrem sourceFileName nebyl destinationFileName nalezen.

IOException

Při otevírání souboru došlo k vstupně-výstupní chybě.

nebo

sourceFileName a destinationFileName zadejte stejný soubor.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

UnauthorizedAccessException

Parametr sourceFileName určuje destinationFileName soubor, který je jen pro čtení.

nebo

Tato operace není na aktuální platformě podporovaná.

nebo

Zdrojové nebo cílové parametry určují adresář místo souboru.

nebo

Volající nemá požadované oprávnění.

-nebo

sourceFileName a destinationFileName zadejte stejný existující adresář.

Příklady

Následující příklad kódu používá metodu Replace k nahrazení souboru jiným souborem a vytvoření zálohy nahrazeného souboru.

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

Poznámky

Metoda Replace nahradí obsah zadaného souboru obsahem jiného souboru. Vytvoří také zálohu souboru, který byl nahrazen.

Pokud nechcete vytvořit zálohu nahrazeného souboru, předejte null ho destinationBackupFileName parametru.

Pokud už soubor destinationBackupFileName existuje, nahradí se obsahem destinationFileName souboru.

Platí pro

Váš názor

Byla tato stránka užitečná?