File.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 contenido de otro archivo, elimina el archivo original y crea una copia de seguridad del archivo reemplazado.
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. |
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. |
Comentarios
Los Replace métodos 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 con el contenido de otro archivo, elimina el archivo original y crea 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 al archivo especificado por destinationFileName
.
- destinationFileName
- String
Nombre del archivo que se reemplaza.
- destinationBackupFileName
- String
El nombre del archivo de copia de seguridad.
Excepciones
La ruta de acceso descrita por el parámetro destinationFileName
no tiene un formato válido.
O bien
La ruta de acceso descrita por el parámetro destinationBackupFileName
no tiene un formato válido.
El parámetro destinationFileName
es null
.
Se especificó una unidad no válida.
No se encontró el archivo descrito por el objeto FileInfo actual.
O bien
No se encontró el archivo que describe el parámetro destinationBackupFileName
.
Se produjo un error de E/S al abrir el archivo.
o bien
Los parámetros sourceFileName
y destinationFileName
especifican el mismo archivo.
La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.
El parámetro sourceFileName
o destinationFileName
especifica un archivo que es de solo lectura.
o bien
Esta operación no es compatible con la plataforma actual.
o bien
Los parámetros de origen o de destino especifican un directorio en lugar de un archivo.
o bien
El llamador no dispone del permiso requerido.
, o
sourceFileName
y destinationFileName
especifican el mismo directorio existente.
Ejemplos
En el ejemplo de código 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)
{
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 Replace método 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 y sourceFileName
destinationFileName
están en volúmenes diferentes, este método generará una excepción. destinationBackupFileName
Si está en un volumen diferente del archivo de origen, se eliminará el archivo de copia de seguridad.
Pase null
al destinationBackupFileName
parámetro si no desea crear una copia de seguridad del archivo que se va a reemplazar.
destinationBackupFileName
Si ya existe, se reemplazará por el contenido del destinationFileName
archivo.
Se aplica a
Replace(String, String, String, Boolean)
- Source:
- File.cs
- Source:
- File.cs
- Source:
- File.cs
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.
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 al archivo especificado por destinationFileName
.
- destinationFileName
- String
Nombre del archivo que se reemplaza.
- destinationBackupFileName
- String
El nombre del archivo de copia de seguridad.
- 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
.
Excepciones
La ruta de acceso descrita por el parámetro destinationFileName
no tiene un formato válido.
O bien
La ruta de acceso descrita por el parámetro destinationBackupFileName
no tiene un formato válido.
El parámetro destinationFileName
es null
.
Se especificó una unidad no válida.
No se encontró el archivo descrito por el objeto FileInfo actual.
O bien
No se encontró el archivo que describe el parámetro destinationBackupFileName
.
Se produjo un error de E/S al abrir el archivo.
o bien
Los parámetros sourceFileName
y destinationFileName
especifican el mismo archivo.
La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.
El parámetro sourceFileName
o destinationFileName
especifica un archivo que es de solo lectura.
o bien
Esta operación no es compatible con la plataforma actual.
o bien
Los parámetros de origen o de destino especifican un directorio en lugar de un archivo.
o bien
El llamador no dispone del permiso requerido.
, o
sourceFileName
y destinationFileName
especifican el mismo directorio existente.
Ejemplos
En el ejemplo de código 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)
{
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 Replace método 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 y sourceFileName
destinationFileName
están en volúmenes diferentes, este método generará una excepción. destinationBackupFileName
Si está en un volumen diferente del archivo de origen, se eliminará el archivo de copia de seguridad.
Pase null
al destinationBackupFileName
parámetro si no desea crear una copia de seguridad del archivo que se va a reemplazar.
destinationBackupFileName
Si ya existe, se reemplazará por el contenido del destinationFileName
archivo.
Se aplica a
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de