File.Replace Méthode

Définition

Espace de noms:: System.IO

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

Nom	Description
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 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)

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);

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 ou destinationBackupFileName le destinationFileName paramètre n’est pas d’une forme juridique.

ArgumentNullException

Le destinationFileName paramètre est null.

DriveNotFoundException

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

FileNotFoundException

Le fichier décrit par ou destinationFileName par sourceFileName paramètre est introuvable.

IOException

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

-ou-

Les sourceFileName paramètres et destinationFileName les paramètres 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 ou destinationFileName le sourceFileName paramètre 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 Replace méthode pour remplacer un fichier par un autre fichier et créer une sauvegarde du fichier remplacé.

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 les sourceFileName volumes et destinationFileName se trouvent sur différents volumes, cette méthode déclenche une exception. Si le destinationBackupFileName volume se trouve sur un autre volume que le 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.

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

S’applique à

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.

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);

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 ou destinationBackupFileName le destinationFileName paramètre n’est pas d’une forme juridique.

ArgumentNullException

Le destinationFileName paramètre est null.

DriveNotFoundException

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

FileNotFoundException

Le fichier décrit par ou destinationFileName par sourceFileName paramètre est introuvable.

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 ou destinationFileName le sourceFileName paramètre 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 Replace méthode pour remplacer un fichier par un autre fichier et créer une sauvegarde du fichier remplacé.

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

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

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

S’applique à

Commentaires

Cette page a-t-elle été utile ?