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 FileInfo.Replace (String, String, Boolean)

 

Data di pubblicazione: ottobre 2016

Sostituisce il contenuto di un file specificato con il file descritto dall'oggetto FileInfo corrente, eliminando il file originale e creando una copia di backup del file sostituito. Specifica inoltre se ignorare gli errori di unione.

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

[ComVisibleAttribute(false)]
public FileInfo Replace(
	string destinationFileName,
	string destinationBackupFileName,
	bool ignoreMetadataErrors
)

Parametri

destinationFileName
Type: System.String

Nome di un file da sostituire con il file corrente.

destinationBackupFileName
Type: System.String

Nome del file con il quale creare una copia di backup del file descritto dal parametro destFileName.

ignoreMetadataErrors
Type: System.Boolean

true per ignorare gli errori di unione (ad esempio gli attributi e gli ACL) dal file sostituito al file di sostituzione; in caso contrario, false.

Valore restituito

Type: System.IO.FileInfo

Oggetto FileInfo che incapsula le informazioni relative al file descritto dal parametro destFileName.

Exception Condition
ArgumentException

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

-oppure-

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

ArgumentNullException

Il valore del parametro destFileName è null.

FileNotFoundException

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

-oppure-

Il file descritto dal parametro destinationFileName non è stato trovato.

PlatformNotSupportedException

Il sistema operativo corrente non è Microsoft Windows NT o versioni successive.

Il Replace metodo sostituisce il contenuto di un file specificato con il contenuto del file descritto dall'oggetto corrente FileInfo oggetto. Verrà inoltre creata una copia di backup del file che è stato sostituito. Infine, viene restituito un nuovo FileInfo oggetto che descrive il file sovrascritto.

System_CAPS_cautionAttenzione

Questo metodo avrà esito positivo in ambienti Windows 2000, se il destFileName è di sola lettura e non genererà un'eccezione. Utilizzare la IsReadOnly proprietà per controllare se il file di destinazione è di sola lettura prima di tentare di sostituirlo.

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

Nell'esempio seguente viene utilizzata la 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
            {
                // 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

FileIOPermission

Associated enumerations: F:System.Security.Permissions.FileIOPermissionAccess.Read , F:System.Security.Permissions.FileIOPermissionAccess.Write

Security Action: Demand.

For permission to read and write to the current file and the file described by the destFileName parameter.

FileIOPermission

Associated enumeration: F:System.Security.Permissions.FileIOPermissionAccess.Write

Security Action: Demand.

For permission to write to file described by the destBackupFileName parameter if one is specified.

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