FileInfo.Replace Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Заменяет содержимое заданного файла на содержимое файла, которое описано в текущем объекте FileInfo, удаляет исходный файл и создает резервную копию замененного файла.
Перегрузки
Replace(String, String) |
Заменяет содержимое заданного файла на содержимое файла, которое описано в текущем объекте FileInfo, удаляет исходный файл и создает резервную копию замененного файла. |
Replace(String, String, Boolean) |
Заменяет содержимое заданного файла на содержимое файла, которое описано в текущем объекте FileInfo, удаляет исходный файл и создает резервную копию замененного файла. Также позволяет определить, нужно ли игнорировать ошибки слияния. |
Комментарии
Используйте методы , Replace если необходимо быстро заменить файл содержимым файла, описанного текущим FileInfo объектом .
Replace(String, String)
- Исходный код:
- FileInfo.cs
- Исходный код:
- FileInfo.cs
- Исходный код:
- FileInfo.cs
Заменяет содержимое заданного файла на содержимое файла, которое описано в текущем объекте FileInfo, удаляет исходный файл и создает резервную копию замененного файла.
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
Параметры
- destinationFileName
- String
Имя файла, который необходимо заменить текущим файлом.
- destinationBackupFileName
- String
Имя файла, с которым необходимо создать резервную копию файла, описанного параметром destFileName
.
Возвращаемое значение
Объект FileInfo, который инкапсулирует сведения о файле, описанные параметром destFileName
.
- Атрибуты
Исключения
Путь, описываемый параметром destFileName
, имел недопустимую форму.
-или-
Путь, описываемый параметром destBackupFileName
, имел недопустимую форму.
Параметр destFileName
имеет значение null
.
Не удалось найти файл, описанный текущим объектом FileInfo.
-или-
Файл, описываемый параметром destinationFileName
, не найден.
Текущая операционная система не является системой Microsoft Windows NT или более поздней версии.
Примеры
В следующем примере метод используется Replace для замены файла другим файлом и создания резервной копии замененного файла.
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
Комментарии
Метод Replace заменяет содержимое указанного файла содержимым файла, описанного текущим FileInfo объектом . Он также создает резервную копию файла, который был заменен. Наконец, он возвращает новый FileInfo объект , описывающий перезаписанный файл.
Передайте null
в параметр , destBackupFileName
если вы не хотите создавать резервную копию заменяемого файла.
Применяется к
Replace(String, String, Boolean)
- Исходный код:
- FileInfo.cs
- Исходный код:
- FileInfo.cs
- Исходный код:
- FileInfo.cs
Заменяет содержимое заданного файла на содержимое файла, которое описано в текущем объекте FileInfo, удаляет исходный файл и создает резервную копию замененного файла. Также позволяет определить, нужно ли игнорировать ошибки слияния.
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
Параметры
- destinationFileName
- String
Имя файла, который необходимо заменить текущим файлом.
- destinationBackupFileName
- String
Имя файла, с которым необходимо создать резервную копию файла, описанного параметром destFileName
.
- ignoreMetadataErrors
- Boolean
Значение true
позволяет игнорировать ошибки слияния (например атрибуты и списки ACL), исходящие из заменяемого файла в заменяющий; в противном случае — значение false
.
Возвращаемое значение
Объект FileInfo, который инкапсулирует сведения о файле, описанные параметром destFileName
.
- Атрибуты
Исключения
Путь, описываемый параметром destFileName
, имел недопустимую форму.
-или-
Путь, описываемый параметром destBackupFileName
, имел недопустимую форму.
Параметр destFileName
имеет значение null
.
Не удалось найти файл, описанный текущим объектом FileInfo.
-или-
Файл, описываемый параметром destinationFileName
, не найден.
Текущая операционная система не является системой Microsoft Windows NT или более поздней версии.
Примеры
В следующем примере метод используется Replace для замены файла другим файлом и создания резервной копии замененного файла.
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
Комментарии
Метод Replace заменяет содержимое указанного файла содержимым файла, описанного текущим FileInfo объектом . Он также создает резервную копию файла, который был заменен. Наконец, он возвращает новый FileInfo объект , описывающий перезаписанный файл.
Передайте null
в параметр , destBackupFileName
если вы не хотите создавать резервную копию заменяемого файла.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по