File.Replace Método

Referencia

Definición

Espacio de nombres:: System.IO

Ensamblado:: System.IO.FileSystem.dll

Ensamblado:: System.Runtime.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Reemplaza el contenido de un archivo especificado por el contenido de otro archivo, eliminando el archivo original y creando una copia de seguridad del archivo reemplazado.

Sobrecargas

Replace(String, String, String)	Reemplaza el contenido de un archivo especificado por el contenido de otro archivo, eliminando el archivo original y creando una copia de seguridad del archivo reemplazado.
Replace(String, String, String, Boolean)	Reemplaza el contenido de un archivo especificado por el contenido de otro archivo, eliminando el archivo original y creando una copia de seguridad del archivo reemplazado y, opcionalmente, omite los errores de combinación.

Comentarios

Los métodos Replace reemplazan el contenido de un archivo especificado por el contenido de otro archivo. También crean una copia de seguridad del archivo que se ha reemplazado.

Replace(String, String, String)

Source:: File.cs

Source:: File.cs

Source:: File.cs

Reemplaza el contenido de un archivo especificado por el contenido de otro archivo, eliminando el archivo original y creando una copia de seguridad del archivo reemplazado.

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)

Parámetros

sourceFileName: String

Nombre de un archivo que reemplaza el archivo especificado por destinationFileName.

destinationFileName: String

Nombre del archivo que se va a reemplazar.

destinationBackupFileName: String

Nombre del archivo de copia de seguridad.

Excepciones

ArgumentException

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

ArgumentNullException

El parámetro destinationFileName es null.

DriveNotFoundException

Se especificó una unidad no válida.

FileNotFoundException

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

IOException

Error de E/S al abrir el archivo.

-o-

Los parámetros sourceFileName y destinationFileName especifican el mismo archivo.

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

UnauthorizedAccessException

El parámetro sourceFileName o destinationFileName especifica un archivo que es de solo lectura.

-o-

Esta operación no se admite en la plataforma actual.

-o-

Los parámetros de origen o destino especifican un directorio en lugar de un archivo.

-o-

El autor de la llamada no tiene el permiso necesario.

-o

sourceFileName y destinationFileName especifiquen el mismo directorio existente.

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.

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

Comentarios

El método Replace reemplaza el contenido de un archivo especificado por el contenido de otro archivo. También crea una copia de seguridad del archivo que se ha reemplazado.

Si el sourceFileName y el destinationFileName están en volúmenes diferentes, este método genera una excepción. Si el destinationBackupFileName está en un volumen diferente del archivo de origen, se eliminará el archivo de copia de seguridad.

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

Si el destinationBackupFileName ya existe, se reemplaza por el contenido del archivo destinationFileName.

Se aplica a

Replace(String, String, String, Boolean)

Source:: File.cs

Source:: File.cs

Source:: File.cs

Reemplaza el contenido de un archivo especificado por el contenido de otro archivo, eliminando el archivo original y creando una copia de seguridad del archivo reemplazado y, opcionalmente, omite los errores de combinación.

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)

Parámetros

sourceFileName: String

Nombre de un archivo que reemplaza el archivo especificado por destinationFileName.

destinationFileName: String

Nombre del archivo que se va a reemplazar.

destinationBackupFileName: String

Nombre del archivo de copia de seguridad.

ignoreMetadataErrors: Boolean

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

Excepciones

ArgumentException

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

ArgumentNullException

El parámetro destinationFileName es null.

DriveNotFoundException

Se especificó una unidad no válida.

FileNotFoundException

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

IOException

Error de E/S al abrir el archivo.

-o-

sourceFileName y destinationFileName especifiquen el mismo archivo.

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.

UnauthorizedAccessException

El parámetro sourceFileName o destinationFileName especifica un archivo que es de solo lectura.

-o-

Esta operación no se admite en la plataforma actual.

-o-

Los parámetros de origen o destino especifican un directorio en lugar de un archivo.

-o-

El autor de la llamada no tiene el permiso necesario.

-o

sourceFileName y destinationFileName especifiquen el mismo directorio existente.

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.

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

Comentarios

El método Replace reemplaza el contenido de un archivo especificado por el contenido de otro archivo. También crea una copia de seguridad del archivo que se ha reemplazado.

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

Si el destinationBackupFileName ya existe, se reemplaza por el contenido del archivo destinationFileName.

Se aplica a

Compartir vía

File.Replace Método

Definición

Sobrecargas

Comentarios

Replace(String, String, String)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

Replace(String, String, String, Boolean)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

Recursos adicionales