FileInfo.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 fichier décrit par l’objet actif FileInfo , la suppression du fichier d’origine et la création d’une sauvegarde du fichier remplacé.

Surcharges

Nom	Description
Replace(String, String)	Remplace le contenu d’un fichier spécifié par le fichier décrit par l’objet actif FileInfo , la suppression du fichier d’origine et la création d’une sauvegarde du fichier remplacé.
Replace(String, String, Boolean)	Remplace le contenu d’un fichier spécifié par le fichier décrit par l’objet actif FileInfo , la suppression du fichier d’origine et la création d’une sauvegarde du fichier remplacé. Spécifie également s’il faut ignorer les erreurs de fusion.

Remarques

Utilisez les Replace méthodes lorsque vous devez remplacer rapidement un fichier par le contenu du fichier décrit par l’objet actuel FileInfo .

Replace(String, String)

Remplace le contenu d’un fichier spécifié par le fichier décrit par l’objet actif FileInfo , la suppression du fichier d’origine et la création d’une sauvegarde du fichier remplacé.

public:
 System::IO::FileInfo ^ Replace(System::String ^ destinationFileName, System::String ^ destinationBackupFileName);

[System.Runtime.InteropServices.ComVisible(false)]
public System.IO.FileInfo Replace(string destinationFileName, string destinationBackupFileName);

public System.IO.FileInfo Replace(string destinationFileName, string destinationBackupFileName);

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Replace : string * string -> System.IO.FileInfo

member this.Replace : string * string -> System.IO.FileInfo

Public Function Replace (destinationFileName As String, destinationBackupFileName As String) As FileInfo

Paramètres

destinationFileName: String

Nom d’un fichier à remplacer par le fichier actif.

destinationBackupFileName: String

Nom d’un fichier avec lequel créer une sauvegarde du fichier décrit par le destinationFileName paramètre.

Retours

FileInfo

Objet FileInfo qui encapsule des informations sur le fichier décrit par le destinationFileName paramètre.

Attributs: ComVisibleAttribute

Exceptions

ArgumentException

Le chemin décrit par le destinationFileName paramètre n’était pas d’une forme juridique.

-ou-

Le chemin décrit par le destinationBackupFileName paramètre n’était pas d’une forme juridique.

ArgumentNullException

Le destinationFileName paramètre est null.

FileNotFoundException

Impossible de trouver le fichier décrit par l’objet actuel FileInfo .

-ou-

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

PlatformNotSupportedException

Le système d’exploitation actuel n’est pas Microsoft Windows NT ou version ultérieure.

Exemples

L’exemple 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
            {
                // originalFile and fileToReplace must contain the path to files that already exist in the
                // file system. backUpOfFileToReplace is created during the execution of the Replace method.

                string originalFile  = "test.txt";
                string fileToReplace = "test2.txt";
                string backUpOfFileToReplace = "test2.txt.bak";

                if (File.Exists(originalFile) && (File.Exists(fileToReplace)))
                {
                    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");
                }
                else
                {
                    Console.WriteLine("Either the file {0} or {1} doesn't " + "exist.", originalFile, fileToReplace);
                }
            }
            catch (Exception e)
            {
                Console.WriteLine(e.Message);
            }

            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)
        {
            // Create a new FileInfo object.
            FileInfo fInfo = new FileInfo(fileToMoveAndDelete);

            // replace the file.
            fInfo.Replace(fileToReplace, backupOfFileToReplace, false);
        }
    }
}
//Move the contents of test.txt into test2.txt, delete test.txt, and
//create a backup of test2.txt.
//Done

Imports System.IO

Module FileExample

    Sub Main()
        Try
            ' originalFile and fileToReplace must contain the path to files that already exist in the  
            ' file system. backUpOfFileToReplace is created during the execution of the Replace method.

            Dim originalFile As String = "test.xml"
            Dim fileToReplace As String = "test2.xml"
            Dim backUpOfFileToReplace As String = "test2.xml.bak"

            If (File.Exists(originalFile) And (File.Exists(fileToReplace))) Then
                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")

            Else
                Console.WriteLine("Either the file {0} or {1} doesn't " + "exist.", originalFile, fileToReplace)
            End If
        Catch e As Exception
            Console.WriteLine(e.Message)
        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)
        ' Create a new FileInfo object.
        Dim fInfo As New FileInfo(fileToMoveAndDelete)

        ' Replace the file.
        fInfo.Replace(fileToReplace, backupOfFileToReplace, False)

    End Sub
End Module

' Move the contents of test.txt into test2.txt, delete test.txt, and 
' create a backup of test2.txt.
' Done

Remarques

La Replace méthode remplace le contenu d’un fichier spécifié par le contenu du fichier décrit par l’objet actif FileInfo . Il crée également une sauvegarde du fichier qui a été remplacé. Enfin, elle retourne un nouvel FileInfo objet qui décrit le fichier remplacé.

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

S’applique à

Replace(String, String, Boolean)

Remplace le contenu d’un fichier spécifié par le fichier décrit par l’objet actif FileInfo , la suppression du fichier d’origine et la création d’une sauvegarde du fichier remplacé. Spécifie également s’il faut ignorer les erreurs de fusion.

public:
 System::IO::FileInfo ^ Replace(System::String ^ destinationFileName, System::String ^ destinationBackupFileName, bool ignoreMetadataErrors);

[System.Runtime.InteropServices.ComVisible(false)]
public System.IO.FileInfo Replace(string destinationFileName, string destinationBackupFileName, bool ignoreMetadataErrors);

public System.IO.FileInfo Replace(string destinationFileName, string destinationBackupFileName, bool ignoreMetadataErrors);

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Replace : string * string * bool -> System.IO.FileInfo

member this.Replace : string * string * bool -> System.IO.FileInfo

Public Function Replace (destinationFileName As String, destinationBackupFileName As String, ignoreMetadataErrors As Boolean) As FileInfo

Paramètres

destinationFileName: String

Nom d’un fichier à remplacer par le fichier actif.

destinationBackupFileName: String

Nom d’un fichier avec lequel créer une sauvegarde du fichier décrit par le destinationFileName paramètre.

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.

Retours

FileInfo

Objet FileInfo qui encapsule des informations sur le fichier décrit par le destinationFileName paramètre.

Attributs: ComVisibleAttribute

Exceptions

ArgumentException

Le chemin décrit par le destinationFileName paramètre n’était pas d’une forme juridique.

-ou-

Le chemin décrit par le destinationBackupFileName paramètre n’était pas d’une forme juridique.

ArgumentNullException

Le destinationFileName paramètre est null.

FileNotFoundException

Impossible de trouver le fichier décrit par l’objet actuel FileInfo .

-ou-

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

PlatformNotSupportedException

Le système d’exploitation actuel n’est pas Microsoft Windows NT ou version ultérieure.

Exemples

L’exemple 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
            {
                // originalFile and fileToReplace must contain the path to files that already exist in the
                // file system. backUpOfFileToReplace is created during the execution of the Replace method.

                string originalFile  = "test.txt";
                string fileToReplace = "test2.txt";
                string backUpOfFileToReplace = "test2.txt.bak";

                if (File.Exists(originalFile) && (File.Exists(fileToReplace)))
                {
                    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");
                }
                else
                {
                    Console.WriteLine("Either the file {0} or {1} doesn't " + "exist.", originalFile, fileToReplace);
                }
            }
            catch (Exception e)
            {
                Console.WriteLine(e.Message);
            }

            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)
        {
            // Create a new FileInfo object.
            FileInfo fInfo = new FileInfo(fileToMoveAndDelete);

            // replace the file.
            fInfo.Replace(fileToReplace, backupOfFileToReplace, false);
        }
    }
}
//Move the contents of test.txt into test2.txt, delete test.txt, and
//create a backup of test2.txt.
//Done

Imports System.IO

Module FileExample

    Sub Main()
        Try
            ' originalFile and fileToReplace must contain the path to files that already exist in the  
            ' file system. backUpOfFileToReplace is created during the execution of the Replace method.

            Dim originalFile As String = "test.xml"
            Dim fileToReplace As String = "test2.xml"
            Dim backUpOfFileToReplace As String = "test2.xml.bak"

            If (File.Exists(originalFile) And (File.Exists(fileToReplace))) Then
                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")

            Else
                Console.WriteLine("Either the file {0} or {1} doesn't " + "exist.", originalFile, fileToReplace)
            End If
        Catch e As Exception
            Console.WriteLine(e.Message)
        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)
        ' Create a new FileInfo object.
        Dim fInfo As New FileInfo(fileToMoveAndDelete)

        ' Replace the file.
        fInfo.Replace(fileToReplace, backupOfFileToReplace, False)

    End Sub
End Module

' Move the contents of test.txt into test2.txt, delete test.txt, and 
' create a backup of test2.txt.
' Done

Remarques

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

S’applique à

Commentaires

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