FileInfo.Replace Método

Definición

Espacio de nombres:
System.IO
Ensamblados:
netstandard.dll, System.Runtime.dll
Ensamblados:
netstandard.dll, System.IO.FileSystem.dll
Ensamblados:
netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll
Ensamblado:
System.IO.FileSystem.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll

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

Sobrecargas

Nombre Description
Replace(String, String)

Reemplaza el contenido de un archivo especificado por el archivo descrito por el objeto actual FileInfo , 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 actual FileInfo , 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 Replace métodos cuando necesite reemplazar rápidamente un archivo por el contenido del archivo descrito por el objeto actual FileInfo .

Replace(String, String)

Source:
FileInfo.cs
Source:
FileInfo.cs
Source:
FileInfo.cs
Source:
FileInfo.cs
Source:
FileInfo.cs

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

public:
 System::IO::FileInfo ^ Replace(System::String ^ destinationFileName, System::String ^ destinationBackupFileName);
public System.IO.FileInfo Replace(string destinationFileName, string? destinationBackupFileName);
public System.IO.FileInfo Replace(string destinationFileName, string destinationBackupFileName);
[System.Runtime.InteropServices.ComVisible(false)]
public System.IO.FileInfo Replace(string destinationFileName, string destinationBackupFileName);
member this.Replace : string * string -> System.IO.FileInfo
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Replace : string * string -> System.IO.FileInfo
Public Function Replace (destinationFileName As String, destinationBackupFileName As String) As FileInfo

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 destinationFileName parámetro .

Devoluciones

FileInfo

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

Atributos
ComVisibleAttribute

Excepciones

ArgumentException

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

O bien

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

ArgumentNullException

El destinationFileName parámetro es null.

FileNotFoundException

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

O bien

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

PlatformNotSupportedException

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

Ejemplos

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

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

Imports System.IO

Module FileExample

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

            Dim originalFile As String = "test.xml"
            Dim fileToReplace As String = "test2.xml"
            Dim backUpOfFileToReplace As String = "test2.xml.bak"

            If (File.Exists(originalFile) And (File.Exists(fileToReplace))) Then
                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)
            End If
        Catch e As Exception
            Console.WriteLine(e.Message)
        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)
        ' Create a new FileInfo object.
        Dim fInfo As New FileInfo(fileToMoveAndDelete)

        ' Replace the file.
        fInfo.Replace(fileToReplace, backupOfFileToReplace, False)

    End Sub
End Module

' Move the contents of test.txt into test2.txt, delete test.txt, and 
' create a backup of test2.txt.
' Done

Comentarios

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

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

Se aplica a

Replace(String, String, Boolean)

Source:
FileInfo.cs
Source:
FileInfo.cs
Source:
FileInfo.cs
Source:
FileInfo.cs
Source:
FileInfo.cs

Reemplaza el contenido de un archivo especificado por el archivo descrito por el objeto actual FileInfo , 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.

public:
 System::IO::FileInfo ^ Replace(System::String ^ destinationFileName, System::String ^ destinationBackupFileName, bool ignoreMetadataErrors);
public System.IO.FileInfo Replace(string destinationFileName, string? destinationBackupFileName, bool ignoreMetadataErrors);
public System.IO.FileInfo Replace(string destinationFileName, string destinationBackupFileName, bool ignoreMetadataErrors);
[System.Runtime.InteropServices.ComVisible(false)]
public System.IO.FileInfo Replace(string destinationFileName, string destinationBackupFileName, bool ignoreMetadataErrors);
member this.Replace : string * string * bool -> System.IO.FileInfo
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Replace : string * string * bool -> System.IO.FileInfo
Public Function Replace (destinationFileName As String, destinationBackupFileName As String, ignoreMetadataErrors As Boolean) As FileInfo

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 destinationFileName parámetro .

ignoreMetadataErrors
Boolean

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

Devoluciones

FileInfo

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

Atributos
ComVisibleAttribute

Excepciones

ArgumentException

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

O bien

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

ArgumentNullException

El destinationFileName parámetro es null.

FileNotFoundException

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

O bien

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

PlatformNotSupportedException

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

Ejemplos

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

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

Imports System.IO

Module FileExample

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

            Dim originalFile As String = "test.xml"
            Dim fileToReplace As String = "test2.xml"
            Dim backUpOfFileToReplace As String = "test2.xml.bak"

            If (File.Exists(originalFile) And (File.Exists(fileToReplace))) Then
                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)
            End If
        Catch e As Exception
            Console.WriteLine(e.Message)
        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)
        ' Create a new FileInfo object.
        Dim fInfo As New FileInfo(fileToMoveAndDelete)

        ' Replace the file.
        fInfo.Replace(fileToReplace, backupOfFileToReplace, False)

    End Sub
End Module

' Move the contents of test.txt into test2.txt, delete test.txt, and 
' create a backup of test2.txt.
' Done

Comentarios

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

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

Se aplica a