FileInfo.Replace Método
Definición
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 con 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 con 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 con el archivo descrito por el objeto FileInfo actual, eliminando el archivo original y creando una copia de seguridad del archivo reemplazado. También especifica si se van a omitir los errores de fusión mediante 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)
Reemplaza el contenido de un archivo especificado con el archivo descrito por el objeto FileInfo actual, 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 va a reemplazarse con 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 destFileName
.
Devoluciones
Objeto FileInfo que encapsula información sobre el archivo descrito por el parámetro destFileName
.
- Atributos
Excepciones
La ruta de acceso descrita por el parámetro destFileName
no tiene un formato válido.
O bien
La ruta de acceso descrita por el parámetro destBackupFileName
no tiene un formato válido.
El parámetro destFileName
es null
.
No se encontró el archivo descrito por el objeto FileInfo actual.
O bien
No se encontró el archivo que describe el parámetro destinationFileName
.
El sistema operativo actual no es Microsoft Windows NT o 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 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)
{
// Create a new FileInfo object.
FileInfo^ fInfo = gcnew FileInfo(fileToMoveAndDelete);
// replace the file.
fInfo->Replace(fileToReplace, backupOfFileToReplace, false);
}
int 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.xml";
String^ fileToReplace = "test2.xml";
String^ backUpOfFileToReplace = "test2.xml.bak";
if (File::Exists(originalFile) && (File::Exists(fileToReplace)))
{
Console::WriteLine("Move the contents of {0} into {1}, " +
"delete {0}, and create a backup of {1}",
originalFile, 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 (IOException^ ex)
{
Console::WriteLine(ex->Message);
}
}
//This code produces output similar to the following;
//results may vary based on the computer/file structure/etc.:
//
//Move the contents of c:\test1.xml into c:\test2.xml, delete c:\test1.xml,
//and create a backup of c:\test2.xml
//Done
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 destBackupFileName
parámetro si no desea crear una copia de seguridad del archivo que se va a reemplazar.
Se aplica a
Replace(String, String, Boolean)
Reemplaza el contenido de un archivo especificado con el archivo descrito por el objeto FileInfo actual, eliminando el archivo original y creando una copia de seguridad del archivo reemplazado. También especifica si se van a omitir los errores de fusión mediante 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 va a reemplazarse con 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 destFileName
.
- ignoreMetadataErrors
- Boolean
Es true
para omitir los errores de combinación (como de atributos y ACL) del archivo reemplazado en el archivo de reemplazo; de lo contrario, es false
.
Devoluciones
Objeto FileInfo que encapsula información sobre el archivo descrito por el parámetro destFileName
.
- Atributos
Excepciones
La ruta de acceso descrita por el parámetro destFileName
no tiene un formato válido.
O bien
La ruta de acceso descrita por el parámetro destBackupFileName
no tiene un formato válido.
El parámetro destFileName
es null
.
No se encontró el archivo descrito por el objeto FileInfo actual.
O bien
No se encontró el archivo que describe el parámetro destinationFileName
.
El sistema operativo actual no es Microsoft Windows NT o 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 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)
{
// Create a new FileInfo object.
FileInfo^ fInfo = gcnew FileInfo(fileToMoveAndDelete);
// replace the file.
fInfo->Replace(fileToReplace, backupOfFileToReplace, false);
}
int 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.xml";
String^ fileToReplace = "test2.xml";
String^ backUpOfFileToReplace = "test2.xml.bak";
if (File::Exists(originalFile) && (File::Exists(fileToReplace)))
{
Console::WriteLine("Move the contents of {0} into {1}, " +
"delete {0}, and create a backup of {1}",
originalFile, 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 (IOException^ ex)
{
Console::WriteLine(ex->Message);
}
}
//This code produces output similar to the following;
//results may vary based on the computer/file structure/etc.:
//
//Move the contents of c:\test1.xml into c:\test2.xml, delete c:\test1.xml,
//and create a backup of c:\test2.xml
//Done
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 destBackupFileName
parámetro si no desea crear una copia de seguridad del archivo que se va a reemplazar.