File.Replace Metódus

Definíció

Névtér:: System.IO

Szerelvény:: mscorlib.dll

Szerelvény:: netstandard.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Egy megadott fájl tartalmát lecseréli egy másik fájl tartalmára, törli az eredeti fájlt, és biztonsági másolatot készít a lecserélt fájlról.

Túlterhelések

Name	Description
Replace(String, String, String)	Egy megadott fájl tartalmát lecseréli egy másik fájl tartalmára, törli az eredeti fájlt, és biztonsági másolatot készít a lecserélt fájlról.
Replace(String, String, String, Boolean)	Egy megadott fájl tartalmát lecseréli egy másik fájl tartalmára, törli az eredeti fájlt, és biztonsági másolatot készít a lecserélt fájlról, és opcionálisan figyelmen kívül hagyja az egyesítési hibákat.

Megjegyzések

A Replace metódusok egy adott fájl tartalmát egy másik fájl tartalmára cserélik. Emellett létrehoznak egy biztonsági másolatot a lecserélt fájlról.

Replace(String, String, String)

Egy megadott fájl tartalmát lecseréli egy másik fájl tartalmára, törli az eredeti fájlt, és biztonsági másolatot készít a lecserélt fájlról.

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)

Paraméterek

sourceFileName: String

A megadott destinationFileNamefájlt lecserélő fájl neve.

destinationFileName: String

A lecserélt fájl neve.

destinationBackupFileName: String

A biztonsági mentési fájl neve.

Kivételek

ArgumentException

A vagy destinationBackupFileName paraméter destinationFileName által leírt elérési út nem jogi forma.

ArgumentNullException

A destinationFileName paraméter a következő null: .

DriveNotFoundException

Érvénytelen meghajtó lett megadva.

FileNotFoundException

A leírt sourceFileName fájl vagy destinationFileName paraméter nem található.

IOException

A fájl megnyitásakor I/O-hiba történt.

-vagy-

A sourceFileName paraméterek ugyanazt destinationFileName a fájlt adják meg.

PathTooLongException

A megadott elérési út, fájlnév vagy mindkettő meghaladja a rendszer által megadott maximális hosszt.

UnauthorizedAccessException

A sourceFileName vagy destinationFileName paraméter írásvédett fájlt ad meg.

-vagy-

Ez a művelet az aktuális platformon nem támogatott.

-vagy-

A forrás- vagy célparaméterek fájl helyett könyvtárat adnak meg.

-vagy-

A hívó nem rendelkezik a szükséges engedéllyel.

-vagy

sourceFileName és destinationFileName adja meg ugyanazt a meglévő könyvtárat.

Példák

Az alábbi példakód egy másik fájlra cseréli a Replace fájlt, és biztonsági másolatot készít a lecserélt fájlról.

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

Megjegyzések

A Replace metódus egy megadott fájl tartalmát egy másik fájl tartalmára cseréli. Emellett létrehoz egy biztonsági másolatot a lecserélt fájlról.

Ha az sourceFileName és destinationFileName a kötetek különböző köteteken vannak, ez a módszer kivételt eredményez. Ha a destinationBackupFileName forrásfájltól eltérő köteten található, a biztonsági mentési fájl törlődik.

Adja meg null a destinationBackupFileName paramétert, ha nem szeretne biztonsági másolatot készíteni a lecserélt fájlról.

Ha a destinationBackupFileName fájl már létezik, a rendszer lecseréli a destinationFileName fájl tartalmára.

A következőre érvényes:

Replace(String, String, String, Boolean)

Egy megadott fájl tartalmát lecseréli egy másik fájl tartalmára, törli az eredeti fájlt, és biztonsági másolatot készít a lecserélt fájlról, és opcionálisan figyelmen kívül hagyja az egyesítési hibákat.

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)

Paraméterek

sourceFileName: String

A megadott destinationFileNamefájlt lecserélő fájl neve.

destinationFileName: String

A lecserélt fájl neve.

destinationBackupFileName: String

A biztonsági mentési fájl neve.

ignoreMetadataErrors: Boolean

truefigyelmen kívül hagyja az egyesítési hibákat (például attribútumokat és hozzáférés-vezérlési listákat (ACL-eket)) a lecserélt fájlból a cserefájlba; egyéb esetben. false

Kivételek

ArgumentException

A vagy destinationBackupFileName paraméter destinationFileName által leírt elérési út nem jogi forma.

ArgumentNullException

A destinationFileName paraméter a következő null: .

DriveNotFoundException

Érvénytelen meghajtó lett megadva.

FileNotFoundException

A leírt sourceFileName fájl vagy destinationFileName paraméter nem található.

IOException

A fájl megnyitásakor I/O-hiba történt.

-vagy-

sourceFileName és destinationFileName adja meg ugyanazt a fájlt.

PathTooLongException

A megadott elérési út, fájlnév vagy mindkettő meghaladja a rendszer által megadott maximális hosszt.

UnauthorizedAccessException

A sourceFileName vagy destinationFileName paraméter írásvédett fájlt ad meg.

-vagy-

Ez a művelet az aktuális platformon nem támogatott.

-vagy-

A forrás- vagy célparaméterek fájl helyett könyvtárat adnak meg.

-vagy-

A hívó nem rendelkezik a szükséges engedéllyel.

-vagy

sourceFileName és destinationFileName adja meg ugyanazt a meglévő könyvtárat.

Példák

Az alábbi példakód egy másik fájlra cseréli a Replace fájlt, és biztonsági másolatot készít a lecserélt fájlról.

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

Megjegyzések

A Replace metódus egy megadott fájl tartalmát egy másik fájl tartalmára cseréli. Emellett létrehoz egy biztonsági másolatot a lecserélt fájlról.

Adja meg null a destinationBackupFileName paramétert, ha nem szeretne biztonsági másolatot készíteni a lecserélt fájlról.

Ha a destinationBackupFileName fájl már létezik, a rendszer lecseréli a destinationFileName fájl tartalmára.

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?