File.Replace Methode

Definitie

Naamruimte:: System.IO

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee vervangt u de inhoud van een opgegeven bestand door de inhoud van een ander bestand, verwijdert u het oorspronkelijke bestand en maakt u een back-up van het vervangen bestand.

Overloads

Name	Description
Replace(String, String, String)	Hiermee vervangt u de inhoud van een opgegeven bestand door de inhoud van een ander bestand, verwijdert u het oorspronkelijke bestand en maakt u een back-up van het vervangen bestand.
Replace(String, String, String, Boolean)	Hiermee vervangt u de inhoud van een opgegeven bestand door de inhoud van een ander bestand, verwijdert u het oorspronkelijke bestand en maakt u een back-up van het vervangen bestand en negeert u eventueel samenvoegfouten.

Opmerkingen

De Replace methoden vervangen de inhoud van een opgegeven bestand door de inhoud van een ander bestand. Ze maken ook een back-up van het bestand dat is vervangen.

Replace(String, String, String)

Hiermee vervangt u de inhoud van een opgegeven bestand door de inhoud van een ander bestand, verwijdert u het oorspronkelijke bestand en maakt u een back-up van het vervangen bestand.

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)

Parameters

sourceFileName: String

De naam van een bestand dat het bestand vervangt dat is opgegeven door destinationFileName.

destinationFileName: String

De naam van het bestand dat wordt vervangen.

destinationBackupFileName: String

De naam van het back-upbestand.

Uitzonderingen

ArgumentException

Het pad dat wordt beschreven door de destinationFileName of destinationBackupFileName parameter is niet van een juridische vorm.

ArgumentNullException

De destinationFileName parameter is null.

DriveNotFoundException

Er is een ongeldig station opgegeven.

FileNotFoundException

Het bestand dat wordt beschreven door sourceFileName of destinationFileName de parameter is niet gevonden.

IOException

Er is een I/O-fout opgetreden tijdens het openen van het bestand.

– of –

De sourceFileName en destinationFileName parameters geven hetzelfde bestand op.

PathTooLongException

Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.

UnauthorizedAccessException

De sourceFileName of destinationFileName parameter geeft een bestand op dat alleen-lezen is.

– of –

Deze bewerking wordt niet ondersteund op het huidige platform.

– of –

Bron- of doelparameters geven een map op in plaats van een bestand.

– of –

De beller heeft niet de vereiste machtiging.

-of

sourceFileName en destinationFileName geef dezelfde bestaande map op.

Voorbeelden

In het volgende codevoorbeeld wordt de Replace methode gebruikt om een bestand te vervangen door een ander bestand en een back-up van het vervangen bestand te maken.

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

Opmerkingen

De Replace methode vervangt de inhoud van een opgegeven bestand door de inhoud van een ander bestand. Er wordt ook een back-up gemaakt van het bestand dat is vervangen.

Als de sourceFileName en destinationFileName zich op verschillende volumes bevinden, wordt met deze methode een uitzondering gegenereerd. Als het destinationBackupFileName volume zich op een ander volume bevindt dan het bronbestand, wordt het back-upbestand verwijderd.

Geef null de parameter door destinationBackupFileName als u geen back-up wilt maken van het bestand dat wordt vervangen.

Als het destinationBackupFileName bestand al bestaat, wordt deze vervangen door de inhoud van het destinationFileName bestand.

Van toepassing op

Replace(String, String, String, Boolean)

Hiermee vervangt u de inhoud van een opgegeven bestand door de inhoud van een ander bestand, verwijdert u het oorspronkelijke bestand en maakt u een back-up van het vervangen bestand en negeert u eventueel samenvoegfouten.

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)

Parameters

sourceFileName: String

De naam van een bestand dat het bestand vervangt dat is opgegeven door destinationFileName.

destinationFileName: String

De naam van het bestand dat wordt vervangen.

destinationBackupFileName: String

De naam van het back-upbestand.

ignoreMetadataErrors: Boolean

true samenvoegfouten (zoals kenmerken en toegangsbeheerlijsten (ACL's) van het vervangen bestand naar het vervangen bestand te negeren; anders, false.

Uitzonderingen

ArgumentException

Het pad dat wordt beschreven door de destinationFileName of destinationBackupFileName parameter is niet van een juridische vorm.

ArgumentNullException

De destinationFileName parameter is null.

DriveNotFoundException

Er is een ongeldig station opgegeven.

FileNotFoundException

Het bestand dat wordt beschreven door sourceFileName of destinationFileName de parameter is niet gevonden.

IOException

Er is een I/O-fout opgetreden tijdens het openen van het bestand.

– of –

sourceFileName en destinationFileName geef hetzelfde bestand op.

PathTooLongException

Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.

UnauthorizedAccessException

De sourceFileName of destinationFileName parameter geeft een bestand op dat alleen-lezen is.

– of –

Deze bewerking wordt niet ondersteund op het huidige platform.

– of –

Bron- of doelparameters geven een map op in plaats van een bestand.

– of –

De beller heeft niet de vereiste machtiging.

-of

sourceFileName en destinationFileName geef dezelfde bestaande map op.

Voorbeelden

In het volgende codevoorbeeld wordt de Replace methode gebruikt om een bestand te vervangen door een ander bestand en een back-up van het vervangen bestand te maken.

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

Opmerkingen

De Replace methode vervangt de inhoud van een opgegeven bestand door de inhoud van een ander bestand. Er wordt ook een back-up gemaakt van het bestand dat is vervangen.

Geef null de parameter door destinationBackupFileName als u geen back-up wilt maken van het bestand dat wordt vervangen.

Als het destinationBackupFileName bestand al bestaat, wordt deze vervangen door de inhoud van het destinationFileName bestand.

Van toepassing op

Feedback

Is deze pagina nuttig?