File.Replace Methode

Referenz

Definition

Namespace:: System.IO

Assembly:: System.IO.FileSystem.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ersetzt den Inhalt einer angegebenen Datei mit dem Inhalt einer anderen Datei, löscht die ursprüngliche Datei und erstellt eine Sicherung der ersetzten Datei.

Überlädt

Replace(String, String, String)	Ersetzt den Inhalt einer angegebenen Datei mit dem Inhalt einer anderen Datei, löscht die ursprüngliche Datei und erstellt eine Sicherung der ersetzten Datei.
Replace(String, String, String, Boolean)	Ersetzt den Inhalt einer angegebenen Datei mit dem Inhalt einer anderen Datei, löscht die ursprüngliche Datei, erstellt eine Sicherung der ersetzten Datei und ignoriert optional Fehler beim Merge.

Hinweise

Die Replace Methoden ersetzen den Inhalt einer angegebenen Datei durch den Inhalt einer anderen Datei. Sie erstellen auch eine Sicherung der Datei, die ersetzt wurde.

Replace(String, String, String)

Quelle:: File.cs

Quelle:: File.cs

Quelle:: File.cs

Ersetzt den Inhalt einer angegebenen Datei mit dem Inhalt einer anderen Datei, löscht die ursprüngliche Datei und erstellt eine Sicherung der ersetzten Datei.

public:
 static void Replace(System::String ^ sourceFileName, System::String ^ destinationFileName, System::String ^ destinationBackupFileName);

public static void Replace (string sourceFileName, string destinationFileName, 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)

Parameter

sourceFileName: String

Der Name einer Datei, die die von destinationFileName angegebene Datei ersetzt.

destinationFileName: String

Der Name der Datei, die ersetzt wird.

destinationBackupFileName: String

Der Name der Sicherungsdatei.

Ausnahmen

ArgumentException

Der durch den destinationFileName-Parameter beschriebene Pfad hat ein ungültiges Format.

- oder -

Der durch den destinationBackupFileName-Parameter beschriebene Pfad hat ein ungültiges Format.

ArgumentNullException

Der destinationFileName-Parameter ist null.

DriveNotFoundException

Es wurde ein ungültiges Laufwerk angegeben.

FileNotFoundException

Die durch das aktuelle FileInfo-Objekt beschriebene Datei konnte nicht gefunden werden.

- oder -

Die durch den destinationBackupFileName-Parameter beschriebene Datei konnte nicht gefunden werden.

IOException

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.

- oder -

Die Parameter sourceFileName und destinationFileName geben dieselbe Datei an.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

UnauthorizedAccessException

Der sourceFileName- oder destinationFileName-Parameter gibt eine schreibgeschützte Datei an.

- oder -

Dieser Vorgang wird von der aktuellen Plattform nicht unterstützt.

- oder -

Die Quell- oder Zielparameter geben ein Verzeichnis anstelle einer Datei an.

- oder -

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

-or

sourceFileName und destinationFileName geben Sie dasselbe vorhandene Verzeichnis an.

Beispiele

Im folgenden Codebeispiel wird die Replace -Methode verwendet, um eine Datei durch eine andere Datei zu ersetzen und eine Sicherung der ersetzten Datei zu erstellen.

using namespace System;
using namespace System::IO;


// Move a file into another file, delete the original,
// and create a backup of the replaced file.

void ReplaceFile(String^ fileToMoveAndDelete,
                 String^ fileToReplace, String^ backupOfFileToReplace)
{
    File::Replace(fileToMoveAndDelete, fileToReplace,
        backupOfFileToReplace, false);
}	


int 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 (IOException^ ex)
    {
        Console::WriteLine(ex->Message);
    } 
};

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

Hinweise

Die Replace -Methode ersetzt den Inhalt einer angegebenen Datei durch den Inhalt einer anderen Datei. Außerdem wird eine Sicherung der ersetzten Datei erstellt.

Wenn sich die sourceFileName und destinationFileName auf unterschiedlichen Volumes befinden, löst diese Methode eine Ausnahme aus. Wenn sich auf destinationBackupFileName einem anderen Volume als die Quelldatei befindet, wird die Sicherungsdatei gelöscht.

Übergeben Sie null an den destinationBackupFileName Parameter, wenn Sie keine Sicherung der zu ersetzenden Datei erstellen möchten.

Wenn die destinationBackupFileName bereits vorhanden ist, wird es durch den Inhalt der destinationFileName Datei ersetzt.

Gilt für:

Replace(String, String, String, Boolean)

Quelle:: File.cs

Quelle:: File.cs

Quelle:: File.cs

Ersetzt den Inhalt einer angegebenen Datei mit dem Inhalt einer anderen Datei, löscht die ursprüngliche Datei, erstellt eine Sicherung der ersetzten Datei und ignoriert optional Fehler beim Merge.

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);

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)

Parameter

sourceFileName: String

Der Name einer Datei, die die von destinationFileName angegebene Datei ersetzt.

destinationFileName: String

Der Name der Datei, die ersetzt wird.

destinationBackupFileName: String

Der Name der Sicherungsdatei.

ignoreMetadataErrors: Boolean

true, um Fehler beim Zusammenführen der ersetzten Datei und der Ersetzungsdatei zu ignorieren (z. B. Attribute und Zugriffssteuerungslisten), andernfalls false.

Ausnahmen

ArgumentException

Der durch den destinationFileName-Parameter beschriebene Pfad hat ein ungültiges Format.

- oder -

Der durch den destinationBackupFileName-Parameter beschriebene Pfad hat ein ungültiges Format.

ArgumentNullException

Der destinationFileName-Parameter ist null.

DriveNotFoundException

Es wurde ein ungültiges Laufwerk angegeben.

FileNotFoundException

Die durch das aktuelle FileInfo-Objekt beschriebene Datei konnte nicht gefunden werden.

- oder -

Die durch den destinationBackupFileName-Parameter beschriebene Datei konnte nicht gefunden werden.

IOException

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.

- oder -

Die Parameter sourceFileName und destinationFileName geben dieselbe Datei an.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

UnauthorizedAccessException

Der sourceFileName- oder destinationFileName-Parameter gibt eine schreibgeschützte Datei an.

- oder -

Dieser Vorgang wird von der aktuellen Plattform nicht unterstützt.

- oder -

Die Quell- oder Zielparameter geben ein Verzeichnis anstelle einer Datei an.

- oder -

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

-or

sourceFileName und destinationFileName geben Sie dasselbe vorhandene Verzeichnis an.

Beispiele

Im folgenden Codebeispiel wird die Replace -Methode verwendet, um eine Datei durch eine andere Datei zu ersetzen und eine Sicherung der ersetzten Datei zu erstellen.

using namespace System;
using namespace System::IO;


// Move a file into another file, delete the original,
// and create a backup of the replaced file.

void ReplaceFile(String^ fileToMoveAndDelete,
                 String^ fileToReplace, String^ backupOfFileToReplace)
{
    File::Replace(fileToMoveAndDelete, fileToReplace,
        backupOfFileToReplace, false);
}	


int 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 (IOException^ ex)
    {
        Console::WriteLine(ex->Message);
    } 
};

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

Hinweise

Die Replace -Methode ersetzt den Inhalt einer angegebenen Datei durch den Inhalt einer anderen Datei. Außerdem wird eine Sicherung der ersetzten Datei erstellt.

Übergeben Sie null an den destinationBackupFileName Parameter, wenn Sie keine Sicherung der zu ersetzenden Datei erstellen möchten.

Wenn die destinationBackupFileName bereits vorhanden ist, wird es durch den Inhalt der destinationFileName Datei ersetzt.

Gilt für:

File.Replace Methode

Definition

Überlädt

Hinweise

Replace(String, String, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

Replace(String, String, String, Boolean)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

Feedback

Zusätzliche Ressourcen