File.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 innehållet i en annan fil, tar bort den ursprungliga filen och skapar en säkerhetskopia av den ersatta filen.

Överlagringar

Name	Description
Replace(String, String, String)	Ersätter innehållet i en angiven fil med innehållet i en annan fil, tar bort den ursprungliga filen och skapar en säkerhetskopia av den ersatta filen.
Replace(String, String, String, Boolean)	Ersätter innehållet i en angiven fil med innehållet i en annan fil, tar bort den ursprungliga filen och skapar en säkerhetskopia av den ersatta filen och ignorerar eventuellt sammanslagningsfel.

Kommentarer

Metoderna Replace ersätter innehållet i en angiven fil med innehållet i en annan fil. De skapar också en säkerhetskopia av filen som ersattes.

Replace(String, String, String)

Ersätter innehållet i en angiven fil med innehållet i en annan fil, tar bort den ursprungliga filen och skapar en säkerhetskopia av den ersatta filen.

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)

Parametrar

sourceFileName: String

Namnet på en fil som ersätter filen som anges av destinationFileName.

destinationFileName: String

Namnet på filen som ersätts.

destinationBackupFileName: String

Namnet på säkerhetskopieringsfilen.

Undantag

ArgumentException

Sökvägen som beskrivs av parametern destinationFileName eller destinationBackupFileName är inte av juridisk form.

ArgumentNullException

Parametern destinationFileName är null.

DriveNotFoundException

En ogiltig enhet har angetts.

FileNotFoundException

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

IOException

Ett I/O-fel uppstod när filen öppnades.

-eller-

Parametrarna sourceFileName och destinationFileName anger samma fil.

PathTooLongException

Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden.

UnauthorizedAccessException

Parametern sourceFileName eller destinationFileName anger en fil som är skrivskyddad.

-eller-

Den här åtgärden stöds inte på den aktuella plattformen.

-eller-

Käll- eller målparametrar anger en katalog i stället för en fil.

-eller-

Anroparen har inte den behörighet som krävs.

-eller

sourceFileName och destinationFileName ange samma befintliga katalog.

Exempel

I följande kodexempel 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
            {
                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

Kommentarer

Metoden Replace ersätter innehållet i en angiven fil med innehållet i en annan fil. Den skapar också en säkerhetskopia av filen som har ersatts.

sourceFileName Om och destinationFileName finns på olika volymer genererar den här metoden ett undantag. destinationBackupFileName Om finns på en annan volym än källfilen tas säkerhetskopieringsfilen bort.

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

Om den destinationBackupFileName redan finns ersätts den med innehållet i destinationFileName filen.

Gäller för

Replace(String, String, String, Boolean)

Ersätter innehållet i en angiven fil med innehållet i en annan fil, tar bort den ursprungliga filen och skapar en säkerhetskopia av den ersatta filen och ignorerar eventuellt sammanslagningsfel.

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)

Parametrar

sourceFileName: String

Namnet på en fil som ersätter filen som anges av destinationFileName.

destinationFileName: String

Namnet på filen som ersätts.

destinationBackupFileName: String

Namnet på säkerhetskopieringsfilen.

ignoreMetadataErrors: Boolean

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

Undantag

ArgumentException

Sökvägen som beskrivs av parametern destinationFileName eller destinationBackupFileName är inte av juridisk form.

ArgumentNullException

Parametern destinationFileName är null.

DriveNotFoundException

En ogiltig enhet har angetts.

FileNotFoundException

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

IOException

Ett I/O-fel uppstod när filen öppnades.

-eller-

sourceFileName och destinationFileName ange samma fil.

PathTooLongException

Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden.

UnauthorizedAccessException

Parametern sourceFileName eller destinationFileName anger en fil som är skrivskyddad.

-eller-

Den här åtgärden stöds inte på den aktuella plattformen.

-eller-

Käll- eller målparametrar anger en katalog i stället för en fil.

-eller-

Anroparen har inte den behörighet som krävs.

-eller

sourceFileName och destinationFileName ange samma befintliga katalog.

Exempel

I följande kodexempel 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
            {
                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

Kommentarer

Metoden Replace ersätter innehållet i en angiven fil med innehållet i en annan fil. Den skapar också en säkerhetskopia av filen som har ersatts.

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

Om den destinationBackupFileName redan finns ersätts den med innehållet i destinationFileName filen.

Gäller för

Feedback

Var den här sidan till hjälp?