FileInfo.Replace Metoda

Reference

Definice

Obor názvů:: System.IO

Sestavení:: System.IO.FileSystem.dll

Sestavení:: System.Runtime.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 souborem popsaným aktuálním objektem FileInfo, odstraněním původního souboru a vytvořením zálohy nahrazeného souboru.

Přetížení

Replace(String, String)	Nahradí obsah zadaného souboru souborem popsaným aktuálním objektem FileInfo, odstraněním původního souboru a vytvořením zálohy nahrazeného souboru.
Replace(String, String, Boolean)	Nahradí obsah zadaného souboru souborem popsaným aktuálním objektem FileInfo, odstraněním původního souboru a vytvořením zálohy nahrazeného souboru. Určuje také, jestli se mají ignorovat chyby sloučení.

Poznámky

Pokud potřebujete rychle nahradit soubor obsahem souboru popsaného aktuálním objektem FileInfo, použijte Replace metody.

Replace(String, String)

Zdroj:: FileInfo.cs

Zdroj:: FileInfo.cs

Zdroj:: FileInfo.cs

Nahradí obsah zadaného souboru souborem popsaným aktuálním objektem FileInfo, odstraněním původního souboru a vytvořením zálohy nahrazeného souboru.

public:
 System::IO::FileInfo ^ Replace(System::String ^ destinationFileName, System::String ^ destinationBackupFileName);

public System.IO.FileInfo Replace (string destinationFileName, string? destinationBackupFileName);

public System.IO.FileInfo Replace (string destinationFileName, string destinationBackupFileName);

[System.Runtime.InteropServices.ComVisible(false)]
public System.IO.FileInfo Replace (string destinationFileName, string destinationBackupFileName);

member this.Replace : string * string -> System.IO.FileInfo

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Replace : string * string -> System.IO.FileInfo

Public Function Replace (destinationFileName As String, destinationBackupFileName As String) As FileInfo

Parametry

destinationFileName: String

Název souboru, který se má nahradit aktuálním souborem.

destinationBackupFileName: String

Název souboru, se kterým chcete vytvořit zálohu souboru popsaného parametrem destinationFileName.

Návraty

FileInfo

Objekt FileInfo, který zapouzdřuje informace o souboru popsaném parametrem destinationFileName.

Atributy: ComVisibleAttribute

Výjimky

ArgumentException

Cesta popsaná parametrem destinationFileName nebyla právní forma.

-nebo-

Cesta popsaná parametrem destinationBackupFileName nebyla právní forma.

ArgumentNullException

Parametr destinationFileName je null.

FileNotFoundException

Soubor popsaný aktuálním objektem FileInfo nebyl nalezen.

-nebo-

Soubor popsaný parametrem destinationFileName nebyl nalezen.

PlatformNotSupportedException

Aktuální operační systém není microsoft Windows NT nebo novější.

Příklady

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


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)
{
    // Create a new FileInfo object.
    FileInfo^ fInfo = gcnew FileInfo(fileToMoveAndDelete);

    // replace the file.
    fInfo->Replace(fileToReplace, backupOfFileToReplace, false);
}


int main()
{
    try
    {
        // originalFile and fileToReplace must contain 
        // the path to files that already exist in the  
        // file system. backUpOfFileToReplace is created 
        // during the execution of the Replace method.

        String^ originalFile = "test.xml";
        String^ fileToReplace = "test2.xml";
        String^ backUpOfFileToReplace = "test2.xml.bak";

        if (File::Exists(originalFile) && (File::Exists(fileToReplace)))
        {
            Console::WriteLine("Move the contents of {0} into {1}, " +
                "delete {0}, and create a backup of {1}",
                originalFile, fileToReplace);

            // Replace the file.
            ReplaceFile(originalFile, fileToReplace,
                backUpOfFileToReplace);
            Console::WriteLine("Done");
        }
        else
        {
            Console::WriteLine("Either the file {0} or {1} doesn't " +
                "exist.", originalFile, fileToReplace);
        }
    }
    catch (IOException^ ex)
    {
        Console::WriteLine(ex->Message);
    }
}


//This code produces output similar to the following; 
//results may vary based on the computer/file structure/etc.:
//
//Move the contents of c:\test1.xml into c:\test2.xml, delete c:\test1.xml, 
//and create a backup of c:\test2.xml
//Done

using System;
using System.IO;

namespace FileSystemExample
{
    class FileExample
    {
        public static void Main()
        {
            try
            {
                // originalFile and fileToReplace must contain the path to files that already exist in the
                // file system. backUpOfFileToReplace is created during the execution of the Replace method.

                string originalFile  = "test.txt";
                string fileToReplace = "test2.txt";
                string backUpOfFileToReplace = "test2.txt.bak";

                if (File.Exists(originalFile) && (File.Exists(fileToReplace)))
                {
                    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");
                }
                else
                {
                    Console.WriteLine("Either the file {0} or {1} doesn't " + "exist.", originalFile, fileToReplace);
                }
            }
            catch (Exception e)
            {
                Console.WriteLine(e.Message);
            }

            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)
        {
            // Create a new FileInfo object.
            FileInfo fInfo = new FileInfo(fileToMoveAndDelete);

            // replace the file.
            fInfo.Replace(fileToReplace, backupOfFileToReplace, false);
        }
    }
}
//Move the contents of test.txt into test2.txt, delete test.txt, and
//create a backup of test2.txt.
//Done

Imports System.IO

Module FileExample

    Sub Main()
        Try
            ' originalFile and fileToReplace must contain the path to files that already exist in the  
            ' file system. backUpOfFileToReplace is created during the execution of the Replace method.

            Dim originalFile As String = "test.xml"
            Dim fileToReplace As String = "test2.xml"
            Dim backUpOfFileToReplace As String = "test2.xml.bak"

            If (File.Exists(originalFile) And (File.Exists(fileToReplace))) Then
                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")

            Else
                Console.WriteLine("Either the file {0} or {1} doesn't " + "exist.", originalFile, fileToReplace)
            End If
        Catch e As Exception
            Console.WriteLine(e.Message)
        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)
        ' Create a new FileInfo object.
        Dim fInfo As New FileInfo(fileToMoveAndDelete)

        ' Replace the file.
        fInfo.Replace(fileToReplace, backupOfFileToReplace, False)

    End Sub
End Module

' Move the contents of test.txt into test2.txt, delete test.txt, and 
' create a backup of test2.txt.
' Done

Poznámky

Metoda Replace nahrazuje obsah zadaného souboru obsahem souboru popsaného aktuálním objektem FileInfo. Vytvoří také zálohu souboru, který byl nahrazen. Nakonec vrátí nový FileInfo objekt, který popisuje přepsaný soubor.

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

Platí pro

Replace(String, String, Boolean)

Zdroj:: FileInfo.cs

Zdroj:: FileInfo.cs

Zdroj:: FileInfo.cs

Nahradí obsah zadaného souboru souborem popsaným aktuálním objektem FileInfo, odstraněním původního souboru a vytvořením zálohy nahrazeného souboru. Určuje také, jestli se mají ignorovat chyby sloučení.

public:
 System::IO::FileInfo ^ Replace(System::String ^ destinationFileName, System::String ^ destinationBackupFileName, bool ignoreMetadataErrors);

public System.IO.FileInfo Replace (string destinationFileName, string? destinationBackupFileName, bool ignoreMetadataErrors);

public System.IO.FileInfo Replace (string destinationFileName, string destinationBackupFileName, bool ignoreMetadataErrors);

[System.Runtime.InteropServices.ComVisible(false)]
public System.IO.FileInfo Replace (string destinationFileName, string destinationBackupFileName, bool ignoreMetadataErrors);

member this.Replace : string * string * bool -> System.IO.FileInfo

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Replace : string * string * bool -> System.IO.FileInfo

Public Function Replace (destinationFileName As String, destinationBackupFileName As String, ignoreMetadataErrors As Boolean) As FileInfo

Parametry

destinationFileName: String

Název souboru, který se má nahradit aktuálním souborem.

destinationBackupFileName: String

Název souboru, se kterým chcete vytvořit zálohu souboru popsaného parametrem destinationFileName.

ignoreMetadataErrors: Boolean

true ignorovat chyby sloučení (například atributy a seznamy ACL) z nahrazeného souboru do náhradního souboru; jinak false.

Návraty

FileInfo

Objekt FileInfo, který zapouzdřuje informace o souboru popsaném parametrem destinationFileName.

Atributy: ComVisibleAttribute

Výjimky

ArgumentException

Cesta popsaná parametrem destinationFileName nebyla právní forma.

-nebo-

Cesta popsaná parametrem destinationBackupFileName nebyla právní forma.

ArgumentNullException

Parametr destinationFileName je null.

FileNotFoundException

Soubor popsaný aktuálním objektem FileInfo nebyl nalezen.

-nebo-

Soubor popsaný parametrem destinationFileName nebyl nalezen.

PlatformNotSupportedException

Aktuální operační systém není microsoft Windows NT nebo novější.

Příklady

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


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)
{
    // Create a new FileInfo object.
    FileInfo^ fInfo = gcnew FileInfo(fileToMoveAndDelete);

    // replace the file.
    fInfo->Replace(fileToReplace, backupOfFileToReplace, false);
}


int main()
{
    try
    {
        // originalFile and fileToReplace must contain 
        // the path to files that already exist in the  
        // file system. backUpOfFileToReplace is created 
        // during the execution of the Replace method.

        String^ originalFile = "test.xml";
        String^ fileToReplace = "test2.xml";
        String^ backUpOfFileToReplace = "test2.xml.bak";

        if (File::Exists(originalFile) && (File::Exists(fileToReplace)))
        {
            Console::WriteLine("Move the contents of {0} into {1}, " +
                "delete {0}, and create a backup of {1}",
                originalFile, fileToReplace);

            // Replace the file.
            ReplaceFile(originalFile, fileToReplace,
                backUpOfFileToReplace);
            Console::WriteLine("Done");
        }
        else
        {
            Console::WriteLine("Either the file {0} or {1} doesn't " +
                "exist.", originalFile, fileToReplace);
        }
    }
    catch (IOException^ ex)
    {
        Console::WriteLine(ex->Message);
    }
}


//This code produces output similar to the following; 
//results may vary based on the computer/file structure/etc.:
//
//Move the contents of c:\test1.xml into c:\test2.xml, delete c:\test1.xml, 
//and create a backup of c:\test2.xml
//Done

using System;
using System.IO;

namespace FileSystemExample
{
    class FileExample
    {
        public static void Main()
        {
            try
            {
                // originalFile and fileToReplace must contain the path to files that already exist in the
                // file system. backUpOfFileToReplace is created during the execution of the Replace method.

                string originalFile  = "test.txt";
                string fileToReplace = "test2.txt";
                string backUpOfFileToReplace = "test2.txt.bak";

                if (File.Exists(originalFile) && (File.Exists(fileToReplace)))
                {
                    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");
                }
                else
                {
                    Console.WriteLine("Either the file {0} or {1} doesn't " + "exist.", originalFile, fileToReplace);
                }
            }
            catch (Exception e)
            {
                Console.WriteLine(e.Message);
            }

            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)
        {
            // Create a new FileInfo object.
            FileInfo fInfo = new FileInfo(fileToMoveAndDelete);

            // replace the file.
            fInfo.Replace(fileToReplace, backupOfFileToReplace, false);
        }
    }
}
//Move the contents of test.txt into test2.txt, delete test.txt, and
//create a backup of test2.txt.
//Done

Imports System.IO

Module FileExample

    Sub Main()
        Try
            ' originalFile and fileToReplace must contain the path to files that already exist in the  
            ' file system. backUpOfFileToReplace is created during the execution of the Replace method.

            Dim originalFile As String = "test.xml"
            Dim fileToReplace As String = "test2.xml"
            Dim backUpOfFileToReplace As String = "test2.xml.bak"

            If (File.Exists(originalFile) And (File.Exists(fileToReplace))) Then
                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")

            Else
                Console.WriteLine("Either the file {0} or {1} doesn't " + "exist.", originalFile, fileToReplace)
            End If
        Catch e As Exception
            Console.WriteLine(e.Message)
        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)
        ' Create a new FileInfo object.
        Dim fInfo As New FileInfo(fileToMoveAndDelete)

        ' Replace the file.
        fInfo.Replace(fileToReplace, backupOfFileToReplace, False)

    End Sub
End Module

' Move the contents of test.txt into test2.txt, delete test.txt, and 
' create a backup of test2.txt.
' Done

Poznámky

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

Platí pro

Sdílet prostřednictvím

FileInfo.Replace Metoda

Definice

Přetížení

Poznámky

Replace(String, String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Platí pro

Replace(String, String, Boolean)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Platí pro

Další materiály