File.Replace Metoda
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Nahradí obsah zadaného souboru obsahem jiného souboru, odstraní původní soubor a vytvoří zálohu nahrazeného souboru.
| Replace(String, String, String) |
Nahradí obsah zadaného souboru obsahem jiného souboru, odstraní původní soubor a vytvoří zálohu nahrazeného souboru. |
| Replace(String, String, String, Boolean) |
Nahradí obsah zadaného souboru obsahem jiného souboru, odstraní původní soubor a vytvoří zálohu nahrazeného souboru a volitelně ignoruje chyby sloučení. |
Replace metody nahrazují obsah zadaného souboru obsahem jiného souboru. Vytvoří také zálohu souboru, který byl nahrazen.
- Zdroj:
- File.cs
- Zdroj:
- File.cs
- Zdroj:
- File.cs
Nahradí obsah zadaného souboru obsahem jiného souboru, odstraní původní soubor a vytvoří zálohu nahrazeného souboru.
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 -> unitPublic Shared Sub Replace (sourceFileName As String, destinationFileName As String, destinationBackupFileName As String)Parametry
- sourceFileName
- String
Název souboru, který nahrazuje soubor určený destinationFileName.
- destinationFileName
- String
Název souboru, který se nahrazuje.
- destinationBackupFileName
- String
Název záložního souboru.
Výjimky
Cesta popsaná parametrem destinationFileName nebo destinationBackupFileName není právní forma.
Parametr destinationFileName je null.
Byla zadána neplatná jednotka.
Soubor popsaný sourceFileName nebo parametrem destinationFileName nebyl nalezen.
Při otevírání souboru došlo k vstupně-výstupní chybě.
-nebo-
Parametry sourceFileName a destinationFileName určují stejný soubor.
Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.
Parametr sourceFileName nebo destinationFileName určuje soubor, který je jen pro čtení.
-nebo-
Tato operace není na aktuální platformě podporovaná.
-nebo-
Zdrojové nebo cílové parametry určují adresář místo souboru.
-nebo-
Volající nemá požadované oprávnění.
-nebo
sourceFileName a destinationFileName zadat stejný existující adresář.
Příklady
Následující příklad kódu používá metodu Replace k nahrazení souboru jiným souborem a vytvoření zálohy nahrazeného souboru.
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
Poznámky
Metoda Replace nahrazuje obsah zadaného souboru obsahem jiného souboru. Vytvoří také zálohu souboru, který byl nahrazen.
Pokud jsou sourceFileName a destinationFileName na různých svazcích, tato metoda vyvolá výjimku. Pokud je destinationBackupFileName na jiném svazku než zdrojový soubor, odstraní se záložní soubor.
Pokud nechcete vytvořit zálohu nahrazeného souboru, předejte null parametru destinationBackupFileName.
Pokud destinationBackupFileName již existuje, nahradí se obsahem souboru destinationFileName.
Platí pro
.NET 9 a další verze
| Produkt | Verze |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- Zdroj:
- File.cs
- Zdroj:
- File.cs
- Zdroj:
- File.cs
Nahradí obsah zadaného souboru obsahem jiného souboru, odstraní původní soubor a vytvoří zálohu nahrazeného souboru a volitelně ignoruje chyby sloučení.
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 -> unitPublic Shared Sub Replace (sourceFileName As String, destinationFileName As String, destinationBackupFileName As String, ignoreMetadataErrors As Boolean)Parametry
- sourceFileName
- String
Název souboru, který nahrazuje soubor určený destinationFileName.
- destinationFileName
- String
Název souboru, který se nahrazuje.
- destinationBackupFileName
- String
Název záložního souboru.
- ignoreMetadataErrors
- Boolean
true ignorovat chyby sloučení (například atributy a seznamy řízení přístupu (ACL)) z nahrazeného souboru do náhradního souboru; jinak false.
Výjimky
Cesta popsaná parametrem destinationFileName nebo destinationBackupFileName není právní forma.
Parametr destinationFileName je null.
Byla zadána neplatná jednotka.
Soubor popsaný sourceFileName nebo parametrem destinationFileName nebyl nalezen.
Při otevírání souboru došlo k vstupně-výstupní chybě.
-nebo-
sourceFileName a destinationFileName zadat stejný soubor.
Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.
Parametr sourceFileName nebo destinationFileName určuje soubor, který je jen pro čtení.
-nebo-
Tato operace není na aktuální platformě podporovaná.
-nebo-
Zdrojové nebo cílové parametry určují adresář místo souboru.
-nebo-
Volající nemá požadované oprávnění.
-nebo
sourceFileName a destinationFileName zadat stejný existující adresář.
Příklady
Následující příklad kódu používá metodu Replace k nahrazení souboru jiným souborem a vytvoření zálohy nahrazeného souboru.
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
Poznámky
Metoda Replace nahrazuje obsah zadaného souboru obsahem jiného souboru. Vytvoří také zálohu souboru, který byl nahrazen.
Pokud jsou sourceFileName a destinationFileName na různých svazcích, tato metoda vyvolá výjimku. Pokud je destinationBackupFileName na jiném svazku než zdrojový soubor, odstraní se záložní soubor.
Pokud nechcete vytvořit zálohu nahrazeného souboru, předejte null parametru destinationBackupFileName.
Pokud destinationBackupFileName již existuje, nahradí se obsahem souboru destinationFileName.
Platí pro
.NET 9 a další verze
| Produkt | Verze |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
Zpětná vazba k produktu .NET
.NET je open source projekt. Vyberte odkaz pro poskytnutí zpětné vazby: