File.Replace Método

Definición

Reemplaza el contenido de un archivo especificado con el contenido de otro archivo, elimina el archivo original y crea una copia de seguridad del archivo reemplazado.Replaces the contents of a specified file with the contents of another file, deleting the original file, and creating a backup of the replaced file.

Sobrecargas

Replace(String, String, String)

Reemplaza el contenido de un archivo especificado con el contenido de otro archivo, elimina el archivo original y crea una copia de seguridad del archivo reemplazado.Replaces the contents of a specified file with the contents of another file, deleting the original file, and creating a backup of the replaced file.

Replace(String, String, String, Boolean)

Reemplaza el contenido de un archivo especificado con el contenido de otro archivo, elimina el archivo original, crea una copia de seguridad del archivo reemplazado y, de forma opcional, omite los errores de fusión mediante combinación.Replaces the contents of a specified file with the contents of another file, deleting the original file, and creating a backup of the replaced file and optionally ignores merge errors.

Comentarios

Los métodos Replace reemplazan el contenido de un archivo especificado con el contenido de otro archivo.The Replace methods replace the contents of a specified file with the contents of another file. También crean una copia de seguridad del archivo que se ha reemplazado.They also create a backup of the file that was replaced.

Replace(String, String, String)

Reemplaza el contenido de un archivo especificado con el contenido de otro archivo, elimina el archivo original y crea una copia de seguridad del archivo reemplazado.Replaces the contents of a specified file with the contents of another file, deleting the original file, and creating a backup of the replaced file.

public:
 static void Replace(System::String ^ sourceFileName, System::String ^ destinationFileName, System::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)

Parámetros

sourceFileName
String

Nombre de un archivo que reemplaza al archivo especificado por destinationFileName.The name of a file that replaces the file specified by destinationFileName.

destinationFileName
String

Nombre del archivo que se reemplaza.The name of the file being replaced.

destinationBackupFileName
String

Nombre del archivo de copia de seguridad.The name of the backup file.

Excepciones

La ruta de acceso descrita por el parámetro destinationFileName no tiene un formato válido.The path described by the destinationFileName parameter was not of a legal form.

o bien-or- La ruta de acceso descrita por el parámetro destinationBackupFileName no tiene un formato válido.The path described by the destinationBackupFileName parameter was not of a legal form.

El parámetro destinationFileName es null.The destinationFileName parameter is null.

Se especificó una unidad no válida.An invalid drive was specified.

No se encontró el archivo que describe el objeto FileInfo actual.The file described by the current FileInfo object could not be found.

o bien-or- No se encontró el archivo que describe el parámetro destinationBackupFileName.The file described by the destinationBackupFileName parameter could not be found.

Se produjo un error de E/S al abrir el archivo.An I/O error occurred while opening the file.

O bien-or- Los parámetros sourceFileName y destinationFileName especifican el mismo archivo.The sourceFileName and destinationFileName parameters specify the same file.

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.The specified path, file name, or both exceed the system-defined maximum length.

El sistema operativo es Windows 98 Second Edition o una versión anterior y el sistema de archivos no es NTFS.The operating system is Windows 98 Second Edition or earlier and the files system is not NTFS.

El parámetro sourceFileName o destinationFileName especifica un archivo que es de solo lectura.The sourceFileName or destinationFileName parameter specifies a file that is read-only.

o bien-or- Esta operación no es compatible con la plataforma actual.This operation is not supported on the current platform.

o bien-or- Los parámetros de origen o de destino especifican un directorio en lugar de un archivo.Source or destination parameters specify a directory instead of a file.

o bien-or- El llamador no dispone del permiso requerido.The caller does not have the required permission.

Ejemplos

En el ejemplo de código siguiente se usa el método Replace para reemplazar un archivo por otro archivo y crear una copia de seguridad del archivo reemplazado.The following code example uses the Replace method to replace a file with another file and create a backup of the replaced file.

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

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

Comentarios

El método Replace reemplaza el contenido de un archivo especificado con el contenido de otro archivo.The Replace method replaces the contents of a specified file with the contents of another file. También crea una copia de seguridad del archivo que se ha reemplazado.It also creates a backup of the file that was replaced.

Si el sourceFileName y el destinationFileName están en volúmenes diferentes, este método producirá una excepción.If the sourceFileName and destinationFileName are on different volumes, this method will raise an exception. Si el destinationBackupFileName está en un volumen diferente del archivo de origen, se eliminará el archivo de copia de seguridad.If the destinationBackupFileName is on a different volume from the source file, the backup file will be deleted.

Pase null al parámetro destinationBackupFileName si no desea crear una copia de seguridad del archivo que se va a reemplazar.Pass null to the destinationBackupFileName parameter if you do not want to create a backup of the file being replaced.

Si el destinationBackupFileName ya existe, se sobrescribirá con el contenido del archivo de destinationFileName.If the destinationBackupFileName already exists it will be overwritten with the contents of the destinationFileName file.

Seguridad

FileIOPermission
permiso para escribir en el archivo descrito por el parámetro destinationBackupFileName si se especifica uno.for permission to write to file described by the destinationBackupFileName parameter if one is specified. Acción de seguridad: Bajo.Security action: Demand. Enumeración asociada: WriteAssociated enumeration: Write

Replace(String, String, String, Boolean)

Reemplaza el contenido de un archivo especificado con el contenido de otro archivo, elimina el archivo original, crea una copia de seguridad del archivo reemplazado y, de forma opcional, omite los errores de fusión mediante combinación.Replaces the contents of a specified file with the contents of another file, deleting the original file, and creating a backup of the replaced file and optionally ignores merge errors.

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);
static member Replace : string * string * string * bool -> unit
Public Shared Sub Replace (sourceFileName As String, destinationFileName As String, destinationBackupFileName As String, ignoreMetadataErrors As Boolean)

Parámetros

sourceFileName
String

Nombre de un archivo que reemplaza al archivo especificado por destinationFileName.The name of a file that replaces the file specified by destinationFileName.

destinationFileName
String

Nombre del archivo que se reemplaza.The name of the file being replaced.

destinationBackupFileName
String

Nombre del archivo de copia de seguridad.The name of the backup file.

ignoreMetadataErrors
Boolean

Es true para omitir los errores de combinación (como atributos y listas de control de acceso, ACL) del archivo reemplazado en el archivo de reemplazo; de lo contrario, es false.true to ignore merge errors (such as attributes and access control lists (ACLs)) from the replaced file to the replacement file; otherwise, false.

Excepciones

La ruta de acceso descrita por el parámetro destinationFileName no tiene un formato válido.The path described by the destinationFileName parameter was not of a legal form.

O bien-or- La ruta de acceso descrita por el parámetro destinationBackupFileName no tiene un formato válido.The path described by the destinationBackupFileName parameter was not of a legal form.

El parámetro destinationFileName es null.The destinationFileName parameter is null.

Se especificó una unidad no válida.An invalid drive was specified.

No se encontró el archivo que describe el objeto FileInfo actual.The file described by the current FileInfo object could not be found.

o bien-or- No se encontró el archivo que describe el parámetro destinationBackupFileName.The file described by the destinationBackupFileName parameter could not be found.

Se produjo un error de E/S al abrir el archivo.An I/O error occurred while opening the file.

o bien-or- Los parámetros sourceFileName y destinationFileName especifican el mismo archivo.The sourceFileName and destinationFileName parameters specify the same file.

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.The specified path, file name, or both exceed the system-defined maximum length.

El sistema operativo es Windows 98 Second Edition o una versión anterior y el sistema de archivos no es NTFS.The operating system is Windows 98 Second Edition or earlier and the files system is not NTFS.

El parámetro sourceFileName o destinationFileName especifica un archivo que es de solo lectura.The sourceFileName or destinationFileName parameter specifies a file that is read-only.

o bien-or- Esta operación no es compatible con la plataforma actual.This operation is not supported on the current platform.

O bien-or- Los parámetros de origen o de destino especifican un directorio en lugar de un archivo.Source or destination parameters specify a directory instead of a file.

O bien-or- El llamador no dispone del permiso requerido.The caller does not have the required permission.

Ejemplos

En el ejemplo de código siguiente se usa el método Replace para reemplazar un archivo por otro archivo y crear una copia de seguridad del archivo reemplazado.The following code example uses the Replace method to replace a file with another file and create a backup of the replaced file.

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

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

Comentarios

El método Replace reemplaza el contenido de un archivo especificado con el contenido de otro archivo.The Replace method replaces the contents of a specified file with the contents of another file. También crea una copia de seguridad del archivo que se ha reemplazado.It also creates a backup of the file that was replaced.

Si el sourceFileName y el destinationFileName están en volúmenes diferentes, este método producirá una excepción.If the sourceFileName and destinationFileName are on different volumes, this method will raise an exception. Si el destinationBackupFileName está en un volumen diferente del archivo de origen, se eliminará el archivo de copia de seguridad.If the destinationBackupFileName is on a different volume from the source file, the backup file will be deleted.

Pase null al parámetro destinationBackupFileName si no desea crear una copia de seguridad del archivo que se va a reemplazar.Pass null to the destinationBackupFileName parameter if you do not want to create a backup of the file being replaced.

Si el destinationBackupFileName ya existe, se sobrescribirá con el contenido del archivo de destinationFileName.If the destinationBackupFileName already exists it will be overwritten with the contents of the destinationFileName file.

Seguridad

FileIOPermission
permiso para escribir en el archivo descrito por el parámetro destinationBackupFileName si se especifica uno.for permission to write to file described by the destinationBackupFileName parameter if one is specified. Acción de seguridad: Bajo.Security action: Demand. Enumeración asociada: WriteAssociated enumeration: Write

Se aplica a