File.Replace Metodo

Definizione

Sostituisce il contenuto di un file specificato con il contenuto di un altro file, eliminando il file originale e creando una copia di backup del file sostituito.Replaces the contents of a specified file with the contents of another file, deleting the original file, and creating a backup of the replaced file.

Overload

Replace(String, String, String)

Sostituisce il contenuto di un file specificato con il contenuto di un altro file, eliminando il file originale e creando una copia di backup del file sostituito.Replaces the contents of a specified file with the contents of another file, deleting the original file, and creating a backup of the replaced file.

Replace(String, String, String, Boolean)

Sostituisce il contenuto di un file specificato con il contenuto di un altro file, eliminando il file originale, creando una copia di backup del file sostituito ed eventualmente ignorando gli errori di merge.Replaces the contents of a specified file with the contents of another file, deleting the original file, and creating a backup of the replaced file and optionally ignores merge errors.

Commenti

I metodi Replace sostituiscono il contenuto di un file specificato con il contenuto di un altro file.The Replace methods replace the contents of a specified file with the contents of another file. Viene inoltre creata una copia di backup del file sostituito.They also create a backup of the file that was replaced.

Replace(String, String, String)

Sostituisce il contenuto di un file specificato con il contenuto di un altro file, eliminando il file originale e creando una copia di backup del file sostituito.Replaces the contents of a specified file with the contents of another file, deleting the original file, and creating a backup of the replaced file.

public:
 static void Replace(System::String ^ sourceFileName, System::String ^ destinationFileName, System::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)

Parametri

sourceFileName
String

Nome del file che sostituisce il file specificato da destinationFileName.The name of a file that replaces the file specified by destinationFileName.

destinationFileName
String

Nome del file da sostituire.The name of the file being replaced.

destinationBackupFileName
String

Nome del file di backup.The name of the backup file.

Eccezioni

Il formato del percorso descritto dal parametro destinationFileName non era valido.The path described by the destinationFileName parameter was not of a legal form.

-oppure--or- Il formato del percorso descritto dal parametro destinationBackupFileName non era valido.The path described by the destinationBackupFileName parameter was not of a legal form.

Il valore del parametro destinationFileName è null.The destinationFileName parameter is null.

È stata specificata un'unità non valida.An invalid drive was specified.

Il file descritto dall'oggetto FileInfo corrente non è stato trovato.The file described by the current FileInfo object could not be found.

-oppure--or- Il file descritto dal parametro destinationBackupFileName non è stato trovato.The file described by the destinationBackupFileName parameter could not be found.

Si è verificato un errore di I/O durante l'apertura del file.An I/O error occurred while opening the file.

-oppure--or- I parametri sourceFileName e destinationFileName specificano lo stesso file.The sourceFileName and destinationFileName parameters specify the same file.

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.The specified path, file name, or both exceed the system-defined maximum length.

Il sistema operativo è Windows 98 Second Edition o versioni precedenti e il file system non è NTFS.The operating system is Windows 98 Second Edition or earlier and the files system is not NTFS.

Il parametro sourceFileName o destinationFileName specifica un file di sola lettura.The sourceFileName or destinationFileName parameter specifies a file that is read-only.

-oppure--or- L'operazione non è supportata sulla piattaforma corrente.This operation is not supported on the current platform.

-oppure--or- Il parametro di origine o di destinazione specifica una directory anziché un file.Source or destination parameters specify a directory instead of a file.

-oppure--or- Il chiamante non dispone dell'autorizzazione richiesta.The caller does not have the required permission.

Esempi

Nell'esempio di codice seguente viene usato il metodo Replace per sostituire un file con un altro file e creare un backup del file sostituito.The following code example uses the Replace method to replace a file with another file and create a backup of the replaced file.

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);

        }
    }
}
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

Commenti

Il metodo Replace sostituisce il contenuto di un file specificato con il contenuto di un altro file.The Replace method replaces the contents of a specified file with the contents of another file. Viene inoltre creata una copia di backup del file sostituito.It also creates a backup of the file that was replaced.

Se il sourceFileName e destinationFileName si trovano su volumi diversi, questo metodo genererà un'eccezione.If the sourceFileName and destinationFileName are on different volumes, this method will raise an exception. Se il destinationBackupFileName si trova in un volume diverso dal file di origine, il file di backup verrà eliminato.If the destinationBackupFileName is on a different volume from the source file, the backup file will be deleted.

Passare null al parametro destinationBackupFileName se non si desidera creare un backup del file sostituito.Pass null to the destinationBackupFileName parameter if you do not want to create a backup of the file being replaced.

Se il destinationBackupFileName esiste già, verrà sovrascritto con il contenuto del file di destinationFileName.If the destinationBackupFileName already exists it will be overwritten with the contents of the destinationFileName file.

Sicurezza

FileIOPermission
per l'autorizzazione a scrivere nel file descritto dal parametro destinationBackupFileName se ne è stato specificato uno.for permission to write to file described by the destinationBackupFileName parameter if one is specified. Azione di sicurezza: Domanda.Security action: Demand. Enumerazione associata: WriteAssociated enumeration: Write

Replace(String, String, String, Boolean)

Sostituisce il contenuto di un file specificato con il contenuto di un altro file, eliminando il file originale, creando una copia di backup del file sostituito ed eventualmente ignorando gli errori di merge.Replaces the contents of a specified file with the contents of another file, deleting the original file, and creating a backup of the replaced file and optionally ignores merge errors.

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);
static member Replace : string * string * string * bool -> unit
Public Shared Sub Replace (sourceFileName As String, destinationFileName As String, destinationBackupFileName As String, ignoreMetadataErrors As Boolean)

Parametri

sourceFileName
String

Nome del file che sostituisce il file specificato da destinationFileName.The name of a file that replaces the file specified by destinationFileName.

destinationFileName
String

Nome del file da sostituire.The name of the file being replaced.

destinationBackupFileName
String

Nome del file di backup.The name of the backup file.

ignoreMetadataErrors
Boolean

true per ignorare gli errori di unione (ad esempio gli attributi e gli elenchi di controllo di accesso (ACL)) dal file sostituito al file di sostituzione; in caso contrario, false.true to ignore merge errors (such as attributes and access control lists (ACLs)) from the replaced file to the replacement file; otherwise, false.

Eccezioni

Il formato del percorso descritto dal parametro destinationFileName non era valido.The path described by the destinationFileName parameter was not of a legal form.

-oppure--or- Il formato del percorso descritto dal parametro destinationBackupFileName non era valido.The path described by the destinationBackupFileName parameter was not of a legal form.

Il valore del parametro destinationFileName è null.The destinationFileName parameter is null.

È stata specificata un'unità non valida.An invalid drive was specified.

Il file descritto dall'oggetto FileInfo corrente non è stato trovato.The file described by the current FileInfo object could not be found.

-oppure--or- Il file descritto dal parametro destinationBackupFileName non è stato trovato.The file described by the destinationBackupFileName parameter could not be found.

Si è verificato un errore di I/O durante l'apertura del file.An I/O error occurred while opening the file.

-oppure--or- I parametri sourceFileName e destinationFileName specificano lo stesso file.The sourceFileName and destinationFileName parameters specify the same file.

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.The specified path, file name, or both exceed the system-defined maximum length.

Il sistema operativo è Windows 98 Second Edition o versioni precedenti e il file system non è NTFS.The operating system is Windows 98 Second Edition or earlier and the files system is not NTFS.

Il parametro sourceFileName o destinationFileName specifica un file di sola lettura.The sourceFileName or destinationFileName parameter specifies a file that is read-only.

-oppure--or- L'operazione non è supportata sulla piattaforma corrente.This operation is not supported on the current platform.

-oppure--or- Il parametro di origine o di destinazione specifica una directory anziché un file.Source or destination parameters specify a directory instead of a file.

-oppure--or- Il chiamante non dispone dell'autorizzazione richiesta.The caller does not have the required permission.

Esempi

Nell'esempio di codice seguente viene usato il metodo Replace per sostituire un file con un altro file e creare un backup del file sostituito.The following code example uses the Replace method to replace a file with another file and create a backup of the replaced file.

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);

        }
    }
}
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

Commenti

Il metodo Replace sostituisce il contenuto di un file specificato con il contenuto di un altro file.The Replace method replaces the contents of a specified file with the contents of another file. Viene inoltre creata una copia di backup del file sostituito.It also creates a backup of the file that was replaced.

Se il sourceFileName e destinationFileName si trovano su volumi diversi, questo metodo genererà un'eccezione.If the sourceFileName and destinationFileName are on different volumes, this method will raise an exception. Se il destinationBackupFileName si trova in un volume diverso dal file di origine, il file di backup verrà eliminato.If the destinationBackupFileName is on a different volume from the source file, the backup file will be deleted.

Passare null al parametro destinationBackupFileName se non si desidera creare un backup del file sostituito.Pass null to the destinationBackupFileName parameter if you do not want to create a backup of the file being replaced.

Se il destinationBackupFileName esiste già, verrà sovrascritto con il contenuto del file di destinationFileName.If the destinationBackupFileName already exists it will be overwritten with the contents of the destinationFileName file.

Sicurezza

FileIOPermission
per l'autorizzazione a scrivere nel file descritto dal parametro destinationBackupFileName se ne è stato specificato uno.for permission to write to file described by the destinationBackupFileName parameter if one is specified. Azione di sicurezza: Domanda.Security action: Demand. Enumerazione associata: WriteAssociated enumeration: Write

Si applica a