Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo File.Replace (String, String, String, Boolean)

 

Data di pubblicazione: ottobre 2016

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

Spazio dei nomi:   System.IO
Assembly:  mscorlib (in mscorlib.dll)

public static void Replace(
	string sourceFileName,
	string destinationFileName,
	string destinationBackupFileName,
	bool ignoreMetadataErrors
)

Parametri

sourceFileName
Type: System.String

Nome del file che sostituisce il file specificato da destinationFileName.

destinationFileName
Type: System.String

Nome del file da sostituire.

destinationBackupFileName
Type: System.String

Nome del file di backup.

ignoreMetadataErrors
Type: System.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.

Exception Condition
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. Ad esempio, nelle piattaforme basate su Windows i percorsi devono contenere meno di 248 caratteri e i nomi file meno di 260 caratteri.

PlatformNotSupportedException

Il sistema operativo è Windows 98 Second Edition o versioni precedenti e il file system non è NTFS.

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.

Il Replace metodo sostituisce il contenuto di un file specificato con il contenuto di un altro file. Verrà inoltre creata una copia di backup del file che è stato sostituito.

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

Passare null per il destinationBackupFileName parametro se non si desidera creare un backup del file da sostituire.

Nell'esempio di codice viene illustrato come utilizzare il Replace per sostituire un file con un altro file e creare un backup del file sostituito.

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

        }
    }
}

FileIOPermission

for permission to read and write to the file described by the sourceFileName parameter. Security action: Demand. Associated enumeration: F:System.Security.Permissions.FileIOPermissionAccess.Read

FileIOPermission

for permission to read and write to the file described by the destinationFileName parameter. Security action: Demand. Associated enumerations: F:System.Security.Permissions.FileIOPermissionAccess.Read, F:System.Security.Permissions.FileIOPermissionAccess.Write

FileIOPermission

for permission to write to file described by the destinationBackupFileName parameter if one is specified. Security action: Demand. Associated enumeration: F:System.Security.Permissions.FileIOPermissionAccess.Write

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: