File.Replace Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Remplace le contenu d'un fichier spécifié par le contenu d'un autre fichier, en supprimant le fichier d'origine et en créant une sauvegarde du fichier remplacé.
Surcharges
Replace(String, String, String) |
Remplace le contenu d'un fichier spécifié par le contenu d'un autre fichier, en supprimant le fichier d'origine et en créant une sauvegarde du fichier remplacé. |
Replace(String, String, String, Boolean) |
Remplace le contenu d'un fichier spécifié par le contenu d'un autre fichier, en supprimant le fichier d'origine, en créant une sauvegarde du fichier remplacé et en ignorant éventuellement les erreurs de fusion. |
Remarques
Les Replace méthodes remplacent le contenu d’un fichier spécifié par le contenu d’un autre fichier. Ils créent également une sauvegarde du fichier qui a été remplacé.
Replace(String, String, String)
- Source:
- File.cs
- Source:
- File.cs
- Source:
- File.cs
Remplace le contenu d'un fichier spécifié par le contenu d'un autre fichier, en supprimant le fichier d'origine et en créant une sauvegarde du fichier remplacé.
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)
Paramètres
- sourceFileName
- String
Nom d'un fichier qui remplace le fichier spécifié par destinationFileName
.
- destinationFileName
- String
Nom du fichier à remplacer.
- destinationBackupFileName
- String
Nom du fichier de sauvegarde.
Exceptions
Le chemin décrit par le paramètre destinationFileName
n’avait pas une forme conforme.
- ou -
Le chemin décrit par le paramètre destinationBackupFileName
n’avait pas une forme conforme.
Le paramètre destinationFileName
a la valeur null
.
Un lecteur non valide a été spécifié.
Le fichier décrit par l’objet FileInfo actuel est introuvable.
- ou -
Le fichier décrit par le paramètre destinationBackupFileName
est introuvable.
Une erreur d’E/S s’est produite lors de l’ouverture du fichier.
- ou -
Les paramètres sourceFileName
et destinationFileName
spécifient le même fichier.
Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.
Le paramètre sourceFileName
ou destinationFileName
spécifie un fichier en lecture seule.
- ou -
Cette opération n'est pas prise en charge sur la plateforme actuelle.
- ou -
Les paramètres sources ou de destination spécifient un répertoire au lieu d’un fichier.
- ou -
L'appelant n'a pas l'autorisation requise.
-or
sourceFileName
et destinationFileName
spécifiez le même répertoire existant.
Exemples
L’exemple de code suivant utilise la Replace méthode pour remplacer un fichier par un autre fichier et créer une sauvegarde du fichier remplacé.
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
Remarques
La Replace méthode remplace le contenu d’un fichier spécifié par le contenu d’un autre fichier. Il crée également une sauvegarde du fichier qui a été remplacé.
Si et sourceFileName
destinationFileName
se trouvent sur des volumes différents, cette méthode lève une exception. Si se destinationBackupFileName
trouve sur un volume différent du fichier source, le fichier de sauvegarde est supprimé.
null
Passez au destinationBackupFileName
paramètre si vous ne souhaitez pas créer de sauvegarde du fichier en cours de remplacement.
S’il destinationBackupFileName
existe déjà, il est remplacé par le contenu du destinationFileName
fichier.
S’applique à
Replace(String, String, String, Boolean)
- Source:
- File.cs
- Source:
- File.cs
- Source:
- File.cs
Remplace le contenu d'un fichier spécifié par le contenu d'un autre fichier, en supprimant le fichier d'origine, en créant une sauvegarde du fichier remplacé et en ignorant éventuellement les erreurs de fusion.
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)
Paramètres
- sourceFileName
- String
Nom d'un fichier qui remplace le fichier spécifié par destinationFileName
.
- destinationFileName
- String
Nom du fichier à remplacer.
- destinationBackupFileName
- String
Nom du fichier de sauvegarde.
- ignoreMetadataErrors
- Boolean
true
pour ignorer les erreurs de fusion (comme les attributs et les listes de contrôle d'accès) du fichier remplacé vers le fichier de remplacement ; sinon, false
.
Exceptions
Le chemin décrit par le paramètre destinationFileName
n’avait pas une forme conforme.
- ou -
Le chemin décrit par le paramètre destinationBackupFileName
n’avait pas une forme conforme.
Le paramètre destinationFileName
a la valeur null
.
Un lecteur non valide a été spécifié.
Le fichier décrit par l’objet FileInfo actuel est introuvable.
- ou -
Le fichier décrit par le paramètre destinationBackupFileName
est introuvable.
Une erreur d’E/S s’est produite lors de l’ouverture du fichier.
- ou -
Les paramètres sourceFileName
et destinationFileName
spécifient le même fichier.
Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.
Le paramètre sourceFileName
ou destinationFileName
spécifie un fichier en lecture seule.
- ou -
Cette opération n'est pas prise en charge sur la plateforme actuelle.
- ou -
Les paramètres sources ou de destination spécifient un répertoire au lieu d’un fichier.
- ou -
L'appelant n'a pas l'autorisation requise.
-or
sourceFileName
et destinationFileName
spécifiez le même répertoire existant.
Exemples
L’exemple de code suivant utilise la Replace méthode pour remplacer un fichier par un autre fichier et créer une sauvegarde du fichier remplacé.
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
Remarques
La Replace méthode remplace le contenu d’un fichier spécifié par le contenu d’un autre fichier. Il crée également une sauvegarde du fichier qui a été remplacé.
Si et sourceFileName
destinationFileName
se trouvent sur des volumes différents, cette méthode lève une exception. Si se destinationBackupFileName
trouve sur un volume différent du fichier source, le fichier de sauvegarde est supprimé.
null
Passez au destinationBackupFileName
paramètre si vous ne souhaitez pas créer de sauvegarde du fichier en cours de remplacement.
S’il destinationBackupFileName
existe déjà, il est remplacé par le contenu du destinationFileName
fichier.
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour