FileInfo.Replace Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zastępuje zawartość określonego pliku plikiem opisanym przez bieżący FileInfo obiekt, usuwając oryginalny plik i tworząc kopię zapasową zastąpionego pliku.
Przeciążenia
Replace(String, String) |
Zastępuje zawartość określonego pliku plikiem opisanym przez bieżący FileInfo obiekt, usuwając oryginalny plik i tworząc kopię zapasową zastąpionego pliku. |
Replace(String, String, Boolean) |
Zastępuje zawartość określonego pliku plikiem opisanym przez bieżący FileInfo obiekt, usuwając oryginalny plik i tworząc kopię zapasową zastąpionego pliku. Określa również, czy ignorować błędy scalania. |
Uwagi
Użyj metod, Replace gdy trzeba szybko zastąpić plik zawartością pliku opisanego przez bieżący FileInfo obiekt.
Replace(String, String)
- Źródło:
- FileInfo.cs
- Źródło:
- FileInfo.cs
- Źródło:
- FileInfo.cs
Zastępuje zawartość określonego pliku plikiem opisanym przez bieżący FileInfo obiekt, usuwając oryginalny plik i tworząc kopię zapasową zastąpionego pliku.
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
Parametry
- destinationFileName
- String
Nazwa pliku do zastąpienia bieżącym plikiem.
- destinationBackupFileName
- String
Nazwa pliku, za pomocą którego ma zostać utworzona kopia zapasowa pliku opisanego destFileName
przez parametr .
Zwraca
FileInfo Obiekt, który hermetyzuje informacje o pliku opisanym destFileName
przez parametr .
- Atrybuty
Wyjątki
Ścieżka opisana przez destFileName
parametr nie była formą prawną.
-lub-
Ścieżka opisana przez destBackupFileName
parametr nie była formą prawną.
Parametr destFileName
to null
.
Nie można odnaleźć pliku opisanego przez bieżący FileInfo obiekt.
-lub-
Nie można odnaleźć pliku opisanego destinationFileName
przez parametr .
Bieżący system operacyjny nie jest systemem Microsoft Windows NT lub nowszym.
Przykłady
W poniższym przykładzie użyto Replace metody , aby zastąpić plik innym plikiem i utworzyć kopię zapasową zastąpionego pliku.
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
Uwagi
Metoda Replace zastępuje zawartość określonego pliku zawartością pliku opisanego przez bieżący FileInfo obiekt. Tworzy również kopię zapasową pliku, który został zastąpiony. Na koniec zwraca nowy FileInfo obiekt opisujący nadpisany plik.
Przekaż null
do parametru destBackupFileName
, jeśli nie chcesz tworzyć kopii zapasowej zastępowanego pliku.
Dotyczy
Replace(String, String, Boolean)
- Źródło:
- FileInfo.cs
- Źródło:
- FileInfo.cs
- Źródło:
- FileInfo.cs
Zastępuje zawartość określonego pliku plikiem opisanym przez bieżący FileInfo obiekt, usuwając oryginalny plik i tworząc kopię zapasową zastąpionego pliku. Określa również, czy ignorować błędy scalania.
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
Parametry
- destinationFileName
- String
Nazwa pliku do zastąpienia bieżącym plikiem.
- destinationBackupFileName
- String
Nazwa pliku, za pomocą którego ma zostać utworzona kopia zapasowa pliku opisanego destFileName
przez parametr .
- ignoreMetadataErrors
- Boolean
true
ignorować błędy scalania (takie jak atrybuty i listy ACL) z zastąpionego pliku do pliku zastępczego; w przeciwnym razie false
.
Zwraca
FileInfo Obiekt, który hermetyzuje informacje o pliku opisanym destFileName
przez parametr .
- Atrybuty
Wyjątki
Ścieżka opisana przez destFileName
parametr nie była formą prawną.
-lub-
Ścieżka opisana przez destBackupFileName
parametr nie była formą prawną.
Parametr destFileName
to null
.
Nie można odnaleźć pliku opisanego przez bieżący FileInfo obiekt.
-lub-
Nie można odnaleźć pliku opisanego destinationFileName
przez parametr .
Bieżący system operacyjny nie jest systemem Microsoft Windows NT lub nowszym.
Przykłady
W poniższym przykładzie użyto Replace metody , aby zastąpić plik innym plikiem i utworzyć kopię zapasową zastąpionego pliku.
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
Uwagi
Metoda Replace zastępuje zawartość określonego pliku zawartością pliku opisanego przez bieżący FileInfo obiekt. Tworzy również kopię zapasową pliku, który został zastąpiony. Na koniec zwraca nowy FileInfo obiekt opisujący nadpisany plik.
Przekaż null
do parametru destBackupFileName
, jeśli nie chcesz tworzyć kopii zapasowej zastępowanego pliku.
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla