File.Replace Méthode

Référence

Définition

Espace de noms:: System.IO

Assembly:: System.IO.FileSystem.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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, 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

ArgumentException

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

ArgumentNullException

Le paramètre destinationFileName est null.

DriveNotFoundException

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

FileNotFoundException

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

IOException

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.

PathTooLongException

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.

UnauthorizedAccessException

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

ArgumentException

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

ArgumentNullException

Le paramètre destinationFileName est null.

DriveNotFoundException

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

FileNotFoundException

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

IOException

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

-ou-

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

PathTooLongException

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.

UnauthorizedAccessException

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é.

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 à

Partager via

File.Replace Méthode

Définition

Surcharges

Remarques

Replace(String, String, String)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

Replace(String, String, String, Boolean)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

Ressources supplémentaires