File.Replace Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.IO
Assembly:
System.IO.FileSystem.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

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.

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

Commenti

I Replace metodi sostituiscono il contenuto di un file specificato con il contenuto di un altro file. Creano anche un backup del file sostituito.

Replace(String, String, String)

Source:
File.cs
Source:
File.cs
Source:
File.cs

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.

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)

Parametri

sourceFileName
String

Nome del file che sostituisce il file specificato da destinationFileName.

destinationFileName
String

Nome del file da sostituire.

destinationBackupFileName
String

Nome del file di backup.

Eccezioni

ArgumentException

Il formato del percorso descritto dal parametro destinationFileName non era valido.

-oppure-

Il formato del percorso descritto dal parametro destinationBackupFileName non era valido.

ArgumentNullException

Il valore del parametro destinationFileName è null.

DriveNotFoundException

È stata specificata un'unità non valida.

FileNotFoundException

Il file descritto dall'oggetto FileInfo corrente non è stato trovato.

-oppure-

Il file descritto dal parametro destinationBackupFileName non è stato trovato.

IOException

Si è verificato un errore di I/O durante l'apertura del file.

-oppure-

I parametri sourceFileName e destinationFileName specificano lo stesso file.

PathTooLongException

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.

UnauthorizedAccessException

Il parametro sourceFileName o destinationFileName specifica un file di sola lettura.

-oppure-

L'operazione non è supportata sulla piattaforma corrente.

-oppure-

Il parametro di origine o di destinazione specifica una directory anziché un file.

-oppure-

Il chiamante non dispone dell'autorizzazione richiesta.

-or

sourceFileName e destinationFileName specificare la stessa directory esistente.

Esempio

Nell'esempio di codice seguente viene usato il Replace metodo per sostituire un file con un altro file e creare un backup del file sostituito.

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

Commenti

Il Replace metodo sostituisce il contenuto di un file specificato con il contenuto di un altro file. Crea anche un backup del file sostituito.

Se e destinationFileName sono in volumi diversi, questo metodo genererà un'eccezionesourceFileName. Se si destinationBackupFileName trova in un volume diverso dal file di origine, il file di backup verrà eliminato.

Passare null al destinationBackupFileName parametro se non si vuole creare un backup del file da sostituire.

Se esiste destinationBackupFileName già, verrà sostituito con il contenuto del destinationFileName file.

Si applica a

Replace(String, String, String, Boolean)

Source:
File.cs
Source:
File.cs
Source:
File.cs

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.

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)

Parametri

sourceFileName
String

Nome del file che sostituisce il file specificato da destinationFileName.

destinationFileName
String

Nome del file da sostituire.

destinationBackupFileName
String

Nome del file di backup.

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.

Eccezioni

ArgumentException

Il formato del percorso descritto dal parametro destinationFileName non era valido.

-oppure-

Il formato del percorso descritto dal parametro destinationBackupFileName non era valido.

ArgumentNullException

Il valore del parametro destinationFileName è null.

DriveNotFoundException

È stata specificata un'unità non valida.

FileNotFoundException

Il file descritto dall'oggetto FileInfo corrente non è stato trovato.

-oppure-

Il file descritto dal parametro destinationBackupFileName non è stato trovato.

IOException

Si è verificato un errore di I/O durante l'apertura del file.

-oppure-

I parametri sourceFileName e destinationFileName specificano lo stesso file.

PathTooLongException

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.

UnauthorizedAccessException

Il parametro sourceFileName o destinationFileName specifica un file di sola lettura.

-oppure-

L'operazione non è supportata sulla piattaforma corrente.

-oppure-

Il parametro di origine o di destinazione specifica una directory anziché un file.

-oppure-

Il chiamante non dispone dell'autorizzazione richiesta.

-or

sourceFileName e destinationFileName specificare la stessa directory esistente.

Esempio

Nell'esempio di codice seguente viene usato il Replace metodo per sostituire un file con un altro file e creare un backup del file sostituito.

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

Commenti

Il Replace metodo sostituisce il contenuto di un file specificato con il contenuto di un altro file. Crea anche un backup del file sostituito.

Se e destinationFileName sono in volumi diversi, questo metodo genererà un'eccezionesourceFileName. Se si destinationBackupFileName trova in un volume diverso dal file di origine, il file di backup verrà eliminato.

Passare null al destinationBackupFileName parametro se non si vuole creare un backup del file da sostituire.

Se esiste destinationBackupFileName già, verrà sostituito con il contenuto del destinationFileName file.

Si applica a