Partager via


File.Replace Méthode

Définition

Remplace le contenu d’un fichier spécifié par le contenu d’un autre fichier, la suppression du fichier d’origine et la création d’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, la suppression du fichier d’origine et la création d’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, la suppression du fichier d’origine et la création d’une sauvegarde du fichier remplacé, et ignore éventuellement les erreurs de fusion.

Remarques

Les méthodes Replace 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, la suppression du fichier d’origine et la création d’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 en cours de remplacement.

destinationBackupFileName
String

Nom du fichier de sauvegarde.

Exceptions

Le chemin décrit par le paramètre destinationFileName ou destinationBackupFileName n’est pas d’une forme légale.

Le paramètre destinationFileName est null.

Un lecteur non valide a été spécifié.

Impossible de trouver le fichier décrit par sourceFileName ou le paramètre destinationFileName.

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 d’accès spécifié, le nom de fichier ou les deux 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 source ou de destination spécifient un répertoire au lieu d’un fichier.

-ou-

L’appelant n’a pas l’autorisation requise.

-ou

sourceFileName et destinationFileName spécifiez le même répertoire existant.

Exemples

L’exemple de code suivant utilise la méthode Replace 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 méthode Replace 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 les sourceFileName et les destinationFileName se trouvent sur différents volumes, cette méthode génère une exception. Si le destinationBackupFileName se trouve sur un volume différent du fichier source, le fichier de sauvegarde est supprimé.

Passez null au paramètre destinationBackupFileName si vous ne souhaitez pas créer de sauvegarde du fichier en cours de remplacement.

Si le destinationBackupFileName existe déjà, il est remplacé par le contenu du fichier destinationFileName.

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, la suppression du fichier d’origine et la création d’une sauvegarde du fichier remplacé, et ignore é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 en cours de remplacement.

destinationBackupFileName
String

Nom du fichier de sauvegarde.

ignoreMetadataErrors
Boolean

true pour ignorer les erreurs de fusion (telles que les attributs et les listes de contrôle d’accès)) du fichier remplacé au fichier de remplacement ; sinon, false.

Exceptions

Le chemin décrit par le paramètre destinationFileName ou destinationBackupFileName n’est pas d’une forme légale.

Le paramètre destinationFileName est null.

Un lecteur non valide a été spécifié.

Impossible de trouver le fichier décrit par sourceFileName ou le paramètre destinationFileName.

Une erreur d’E/S s’est produite lors de l’ouverture du fichier.

-ou-

sourceFileName et destinationFileName spécifiez le même fichier.

Le chemin d’accès spécifié, le nom de fichier ou les deux 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 source ou de destination spécifient un répertoire au lieu d’un fichier.

-ou-

L’appelant n’a pas l’autorisation requise.

-ou

sourceFileName et destinationFileName spécifiez le même répertoire existant.

Exemples

L’exemple de code suivant utilise la méthode Replace 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 méthode Replace 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 les sourceFileName et les destinationFileName se trouvent sur différents volumes, cette méthode génère une exception. Si le destinationBackupFileName se trouve sur un volume différent du fichier source, le fichier de sauvegarde est supprimé.

Passez null au paramètre destinationBackupFileName si vous ne souhaitez pas créer de sauvegarde du fichier en cours de remplacement.

Si le destinationBackupFileName existe déjà, il est remplacé par le contenu du fichier destinationFileName.

S’applique à