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

ArgumentException

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.

ArgumentNullException

Le paramètre destinationFileName a la valeur null.

DriveNotFoundException

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

FileNotFoundException

Le fichier décrit par l’objet FileInfo actuel est introuvable.

- ou -

Le fichier décrit par le paramètre destinationBackupFileName est introuvable.

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 et/ou le nom de fichier spécifiés 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 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 sourceFileNamedestinationFileName 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

ArgumentException

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.

ArgumentNullException

Le paramètre destinationFileName a la valeur null.

DriveNotFoundException

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

FileNotFoundException

Le fichier décrit par l’objet FileInfo actuel est introuvable.

- ou -

Le fichier décrit par le paramètre destinationBackupFileName est introuvable.

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 et/ou le nom de fichier spécifiés 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 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é.

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 à

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 à

Commentaires

Ressources supplémentaires