FileInfo.Replace Método

Definición

Espacio de nombres:

System.IO

Ensamblado:

System.Runtime.dll

Reemplaza el contenido de un archivo especificado por el archivo descrito por el objeto FileInfo actual, eliminando el archivo original y creando una copia de seguridad del archivo reemplazado.

Sobrecargas

Replace(String, String)	Reemplaza el contenido de un archivo especificado por el archivo descrito por el objeto FileInfo actual, eliminando el archivo original y creando una copia de seguridad del archivo reemplazado.
Replace(String, String, Boolean)	Reemplaza el contenido de un archivo especificado por el archivo descrito por el objeto FileInfo actual, eliminando el archivo original y creando una copia de seguridad del archivo reemplazado. Especifica también si se omitirán los errores de combinación.

Comentarios

Use los métodos Replace cuando necesite reemplazar rápidamente un archivo por el contenido del archivo descrito por el objeto FileInfo actual.

Replace(String, String)

Source:

FileInfo.cs

Reemplaza el contenido de un archivo especificado por el archivo descrito por el objeto FileInfo actual, eliminando el archivo original y creando una copia de seguridad del archivo reemplazado.

C#

public System.IO.FileInfo Replace (string destinationFileName, string? destinationBackupFileName);

Parámetros

destinationFileName

String

Nombre de un archivo que se va a reemplazar por el archivo actual.

destinationBackupFileName

String

Nombre de un archivo con el que se va a crear una copia de seguridad del archivo descrito por el parámetro destinationFileName.

Devoluciones

FileInfo

Objeto FileInfo que encapsula información sobre el archivo descrito por el parámetro destinationFileName.

Excepciones

ArgumentException

La ruta de acceso descrita por el parámetro destinationFileName no era de un formulario legal.

-o-

La ruta de acceso descrita por el parámetro destinationBackupFileName no era de un formulario legal.

ArgumentNullException

El parámetro destinationFileName es null.

FileNotFoundException

No se encontró el archivo descrito por el objeto FileInfo actual.

-o-

No se encontró el archivo descrito por el parámetro destinationFileName.

PlatformNotSupportedException

El sistema operativo actual no es Microsoft Windows NT ni posterior.

Ejemplos

En el ejemplo siguiente se usa el método Replace para reemplazar un archivo por otro archivo y crear una copia de seguridad del archivo reemplazado.

C#

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

Comentarios

El método Replace reemplaza el contenido de un archivo especificado por el contenido del archivo descrito por el objeto FileInfo actual. También crea una copia de seguridad del archivo que se ha reemplazado. Por último, devuelve un nuevo objeto FileInfo que describe el archivo sobrescrito.

Pase null al parámetro destinationBackupFileName si no desea crear una copia de seguridad del archivo que se va a reemplazar.

Replace(String, String, Boolean)

Source:

FileInfo.cs

Reemplaza el contenido de un archivo especificado por el archivo descrito por el objeto FileInfo actual, eliminando el archivo original y creando una copia de seguridad del archivo reemplazado. Especifica también si se omitirán los errores de combinación.

C#

public System.IO.FileInfo Replace (string destinationFileName, string? destinationBackupFileName, bool ignoreMetadataErrors);

Parámetros

destinationFileName

String

Nombre de un archivo que se va a reemplazar por el archivo actual.

destinationBackupFileName

String

Nombre de un archivo con el que se va a crear una copia de seguridad del archivo descrito por el parámetro destinationFileName.

ignoreMetadataErrors

Boolean

true omitir los errores de combinación (como atributos y ACL) del archivo reemplazado al archivo de reemplazo; de lo contrario, false.

Devoluciones

FileInfo

Objeto FileInfo que encapsula información sobre el archivo descrito por el parámetro destinationFileName.

Excepciones

ArgumentException

La ruta de acceso descrita por el parámetro destinationFileName no era de un formulario legal.

-o-

La ruta de acceso descrita por el parámetro destinationBackupFileName no era de un formulario legal.

ArgumentNullException

El parámetro destinationFileName es null.

FileNotFoundException

No se encontró el archivo descrito por el objeto FileInfo actual.

-o-

No se encontró el archivo descrito por el parámetro destinationFileName.

PlatformNotSupportedException

El sistema operativo actual no es Microsoft Windows NT ni posterior.

Ejemplos

En el ejemplo siguiente se usa el método Replace para reemplazar un archivo por otro archivo y crear una copia de seguridad del archivo reemplazado.

C#

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

Comentarios

El método Replace reemplaza el contenido de un archivo especificado por el contenido del archivo descrito por el objeto FileInfo actual. También crea una copia de seguridad del archivo que se ha reemplazado. Por último, devuelve un nuevo objeto FileInfo que describe el archivo sobrescrito.

Pase null al parámetro destinationBackupFileName si no desea crear una copia de seguridad del archivo que se va a reemplazar.