FileInfo.Replace Metod

Definition

Namnområde:: System.IO

Sammansättning:: mscorlib.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Ersätter innehållet i en angiven fil med den fil som beskrivs av det aktuella FileInfo objektet, tar bort den ursprungliga filen och skapar en säkerhetskopia av den ersatta filen.

Överlagringar

Name	Description
Replace(String, String)	Ersätter innehållet i en angiven fil med den fil som beskrivs av det aktuella FileInfo objektet, tar bort den ursprungliga filen och skapar en säkerhetskopia av den ersatta filen.
Replace(String, String, Boolean)	Ersätter innehållet i en angiven fil med filen som beskrivs av det aktuella FileInfo objektet, tar bort den ursprungliga filen och skapar en säkerhetskopia av den ersatta filen. Anger också om kopplingsfel ska ignoreras.

Kommentarer

Använd metoderna Replace när du snabbt behöver ersätta en fil med innehållet i filen som beskrivs av det aktuella FileInfo objektet.

Replace(String, String)

Ersätter innehållet i en angiven fil med den fil som beskrivs av det aktuella FileInfo objektet, tar bort den ursprungliga filen och skapar en säkerhetskopia av den ersatta filen.

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

Parametrar

destinationFileName: String

Namnet på en fil som ska ersättas med den aktuella filen.

destinationBackupFileName: String

Namnet på en fil som du vill skapa en säkerhetskopia av filen med som beskrivs av parametern destinationFileName .

Returer

FileInfo

Ett FileInfo objekt som kapslar in information om filen som beskrivs av parametern destinationFileName .

Attribut: ComVisibleAttribute

Undantag

ArgumentException

Sökvägen som beskrivs av parametern destinationFileName var inte av juridisk form.

-eller-

Sökvägen som beskrivs av parametern destinationBackupFileName var inte av juridisk form.

ArgumentNullException

Parametern destinationFileName är null.

FileNotFoundException

Det gick inte att hitta filen som beskrivs av det aktuella FileInfo objektet.

-eller-

Det gick inte att hitta filen som beskrivs av parametern destinationFileName .

PlatformNotSupportedException

Det aktuella operativsystemet är inte Microsoft Windows NT eller senare.

Exempel

I följande exempel används Replace metoden för att ersätta en fil med en annan fil och skapa en säkerhetskopia av den ersatta filen.

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

Kommentarer

Metoden Replace ersätter innehållet i en angiven fil med innehållet i filen som beskrivs av det aktuella FileInfo objektet. Den skapar också en säkerhetskopia av filen som har ersatts. Slutligen returneras ett nytt FileInfo objekt som beskriver den överskrivna filen.

Skicka null till parametern destinationBackupFileName om du inte vill skapa en säkerhetskopia av filen som ersätts.

Gäller för

Replace(String, String, Boolean)

Ersätter innehållet i en angiven fil med filen som beskrivs av det aktuella FileInfo objektet, tar bort den ursprungliga filen och skapar en säkerhetskopia av den ersatta filen. Anger också om kopplingsfel ska ignoreras.

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

Parametrar

destinationFileName: String

Namnet på en fil som ska ersättas med den aktuella filen.

destinationBackupFileName: String

Namnet på en fil som du vill skapa en säkerhetskopia av filen med som beskrivs av parametern destinationFileName .

ignoreMetadataErrors: Boolean

true för att ignorera sammanslagningsfel (till exempel attribut och ACL:er) från den ersatta filen till ersättningsfilen. annars false.

Returer

FileInfo

Ett FileInfo objekt som kapslar in information om filen som beskrivs av parametern destinationFileName .

Attribut: ComVisibleAttribute

Undantag

ArgumentException

Sökvägen som beskrivs av parametern destinationFileName var inte av juridisk form.

-eller-

Sökvägen som beskrivs av parametern destinationBackupFileName var inte av juridisk form.

ArgumentNullException

Parametern destinationFileName är null.

FileNotFoundException

Det gick inte att hitta filen som beskrivs av det aktuella FileInfo objektet.

-eller-

Det gick inte att hitta filen som beskrivs av parametern destinationFileName .

PlatformNotSupportedException

Det aktuella operativsystemet är inte Microsoft Windows NT eller senare.

Exempel

I följande exempel används Replace metoden för att ersätta en fil med en annan fil och skapa en säkerhetskopia av den ersatta filen.

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

Kommentarer

Skicka null till parametern destinationBackupFileName om du inte vill skapa en säkerhetskopia av filen som ersätts.

Gäller för

Feedback

Var den här sidan till hjälp?