Condividi tramite

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 un 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 un 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 e creando un backup del file sostituito e, facoltativamente, ignora gli errori di unione.

Commenti

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

Replace(String, String, String)

Origine:
File.cs
Origine:
File.cs
Origine:
File.cs

Sostituisce il contenuto di un file specificato con il contenuto di un altro file, eliminando il file originale e creando un 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 di un 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 percorso descritto dal parametro destinationFileName o destinationBackupFileName non è valido.

ArgumentNullException

Il parametro destinationFileName è null.

DriveNotFoundException

È stata specificata un'unità non valida.

FileNotFoundException

Impossibile trovare il file descritto da sourceFileName o destinationFileName parametro.

IOException

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

-o-

I parametri sourceFileName e destinationFileName specificano lo stesso file.

PathTooLongException

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

UnauthorizedAccessException

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

-o-

Questa operazione non è supportata nella piattaforma corrente.

-o-

I parametri di origine o di destinazione specificano una directory anziché un file.

-o-

Il chiamante non dispone dell'autorizzazione richiesta.

-o

sourceFileName e destinationFileName specificare la stessa directory esistente.

Esempio

Nell'esempio di codice seguente viene utilizzato il metodo Replace 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 metodo Replace sostituisce il contenuto di un file specificato con il contenuto di un altro file. Crea anche un backup del file sostituito.

Se le sourceFileName e le destinationFileName si trovano in volumi diversi, questo metodo genera un'eccezione. Se il destinationBackupFileName si trova in un volume diverso dal file di origine, il file di backup verrà eliminato.

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

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

Si applica a

Replace(String, String, String, Boolean)

Origine:
File.cs
Origine:
File.cs
Origine:
File.cs

Sostituisce il contenuto di un file specificato con il contenuto di un altro file, eliminando il file originale e creando un backup del file sostituito e, facoltativamente, ignora gli errori di unione.

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 di un 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 ignorare gli errori di unione (ad esempio attributi e elenchi di controllo di accesso)) dal file sostituito al file di sostituzione; in caso contrario, false.

Eccezioni

ArgumentException

Il percorso descritto dal parametro destinationFileName o destinationBackupFileName non è valido.

ArgumentNullException

Il parametro destinationFileName è null.

DriveNotFoundException

È stata specificata un'unità non valida.

FileNotFoundException

Impossibile trovare il file descritto da sourceFileName o destinationFileName parametro.

IOException

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

-o-

sourceFileName e destinationFileName specificare lo stesso file.

PathTooLongException

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

UnauthorizedAccessException

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

-o-

Questa operazione non è supportata nella piattaforma corrente.

-o-

I parametri di origine o di destinazione specificano una directory anziché un file.

-o-

Il chiamante non dispone dell'autorizzazione richiesta.

-o

sourceFileName e destinationFileName specificare la stessa directory esistente.

Esempio

Nell'esempio di codice seguente viene utilizzato il metodo Replace 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 metodo Replace sostituisce il contenuto di un file specificato con il contenuto di un altro file. Crea anche un backup del file sostituito.

Se le sourceFileName e le destinationFileName si trovano in volumi diversi, questo metodo genera un'eccezione. Se il destinationBackupFileName si trova in un volume diverso dal file di origine, il file di backup verrà eliminato.

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

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

Si applica a