File.Replace File.Replace File.Replace File.Replace Method

Definition

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.Replaces the contents of a specified file with the contents of another file, deleting the original file, and creating a backup of the replaced file.

Überlädt

Replace(String, String, String) Replace(String, String, String) Replace(String, String, String) 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.Replaces the contents of a specified file with the contents of another file, deleting the original file, and creating a backup of the replaced file.

Replace(String, String, String, Boolean) Replace(String, String, String, Boolean) Replace(String, String, String, Boolean) 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.Replaces the contents of a specified file with the contents of another file, deleting the original file, and creating a backup of the replaced file and optionally ignores merge errors.

Hinweise

Die Replace Methoden ersetzen Sie den Inhalt einer angegebenen Datei mit dem Inhalt einer anderen Datei.The Replace methods replace the contents of a specified file with the contents of another file. Sie erstellen auch eine Sicherungskopie der Datei, die ersetzt wurde.They also create a backup of the file that was replaced.

Replace(String, String, String) Replace(String, String, String) Replace(String, String, String) 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.Replaces the contents of a specified file with the contents of another file, deleting the original file, and creating a backup of the replaced file.

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)

Parameter

sourceFileName
String String String String

Der Name einer Datei, die die von destinationFileName angegebene Datei ersetzt.The name of a file that replaces the file specified by destinationFileName.

destinationFileName
String String String String

Der Name der Datei, die ersetzt wird.The name of the file being replaced.

destinationBackupFileName
String String String String

Der Name der Sicherungsdatei.The name of the backup file.

Ausnahmen

Der durch den destinationFileName-Parameter beschriebene Pfad hat ein ungültiges Format.The path described by the destinationFileName parameter was not of a legal form.

- oder --or- Der durch den destinationBackupFileName-Parameter beschriebene Pfad hat ein ungültiges Format.The path described by the destinationBackupFileName parameter was not of a legal form.

Der destinationFileName-Parameter ist null.The destinationFileName parameter is null.

Es wurde ein ungültiges Laufwerk angegeben.An invalid drive was specified.

Die durch das aktuelle FileInfo-Objekt beschriebene Datei konnte nicht gefunden werden.The file described by the current FileInfo object could not be found.

- oder --or- Die durch den destinationBackupFileName-Parameter beschriebene Datei konnte nicht gefunden werden.The file described by the destinationBackupFileName parameter could not be found.

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.An I/O error occurred while opening the file.

- oder --or- Die Parameter sourceFileName und destinationFileName geben dieselbe Datei an.The sourceFileName and destinationFileName parameters specify the same file.

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.The specified path, file name, or both exceed the system-defined maximum length.

Das Betriebssystem ist Windows 98 Second Edition oder früher, und das Dateisystem ist nicht NTFS.The operating system is Windows 98 Second Edition or earlier and the files system is not NTFS.

Der sourceFileName- oder destinationFileName-Parameter gibt eine schreibgeschützte Datei an.The sourceFileName or destinationFileName parameter specifies a file that is read-only.

- oder --or- Dieser Vorgang wird von der aktuellen Plattform nicht unterstützt.This operation is not supported on the current platform.

- oder --or- Die Quell- oder Zielparameter geben ein Verzeichnis anstelle einer Datei an.Source or destination parameters specify a directory instead of a file.

- oder --or- Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Beispiele

Im folgenden Codebeispiel wird die Replace Methode, um eine Datei durch eine andere Datei ersetzen, und erstellen Sie eine Sicherung der ersetzten Datei.The following code example uses the Replace method to replace a file with another file and create a backup of the replaced file.

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

        }
    }
}
Imports System
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 mit dem Inhalt einer anderen Datei.The Replace method replaces the contents of a specified file with the contents of another file. Es erstellt auch eine Sicherungskopie der Datei, die ersetzt wurde.It also creates a backup of the file that was replaced.

Wenn die sourceFileName und destinationFileName sind auf unterschiedlichen Volumes wird diese Methode eine Ausnahme ausgelöst.If the sourceFileName and destinationFileName are on different volumes, this method will raise an exception. Wenn die destinationBackupFileName ist auf ein anderes Volume aus der Quelldatei, die Sicherungsdatei gelöscht werden.If the destinationBackupFileName is on a different volume from the source file, the backup file will be deleted.

Übergeben Sie null auf die destinationBackupFileName -Parameters, wenn Sie nicht, erstellen Sie eine Sicherung der ersetzten Datei möchten.Pass null to the destinationBackupFileName parameter if you do not want to create a backup of the file being replaced.

Wenn die destinationBackupFileName bereits vorhanden ist es überschrieben werden mit dem Inhalt der destinationFileName Datei.If the destinationBackupFileName already exists it will be overwritten with the contents of the destinationFileName file.

Sicherheit

FileIOPermission
für die Berechtigung zum Schreiben von beschriebenen Datei der destinationBackupFileName -Parameters, wenn eine angegeben wurde.for permission to write to file described by the destinationBackupFileName parameter if one is specified. Security-Aktion: Bei Bedarf.Security action: Demand. Zugeordnete Enumeration: WriteAssociated enumeration: Write

Replace(String, String, String, Boolean) Replace(String, String, String, Boolean) Replace(String, String, String, Boolean) 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.Replaces the contents of a specified file with the contents of another file, deleting the original file, and creating a backup of the replaced file and optionally ignores merge errors.

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)

Parameter

sourceFileName
String String String String

Der Name einer Datei, die die von destinationFileName angegebene Datei ersetzt.The name of a file that replaces the file specified by destinationFileName.

destinationFileName
String String String String

Der Name der Datei, die ersetzt wird.The name of the file being replaced.

destinationBackupFileName
String String String String

Der Name der Sicherungsdatei.The name of the backup file.

ignoreMetadataErrors
Boolean Boolean Boolean Boolean

true, um Fehler beim Zusammenführen der ersetzten Datei und der Ersetzungsdatei zu ignorieren (z. B. Attribute und Zugriffssteuerungslisten), andernfalls false.true to ignore merge errors (such as attributes and access control lists (ACLs)) from the replaced file to the replacement file; otherwise, false.

Ausnahmen

Der durch den destinationFileName-Parameter beschriebene Pfad hat ein ungültiges Format.The path described by the destinationFileName parameter was not of a legal form.

- oder --or- Der durch den destinationBackupFileName-Parameter beschriebene Pfad hat ein ungültiges Format.The path described by the destinationBackupFileName parameter was not of a legal form.

Der destinationFileName-Parameter ist null.The destinationFileName parameter is null.

Es wurde ein ungültiges Laufwerk angegeben.An invalid drive was specified.

Die durch das aktuelle FileInfo-Objekt beschriebene Datei konnte nicht gefunden werden.The file described by the current FileInfo object could not be found.

- oder --or- Die durch den destinationBackupFileName-Parameter beschriebene Datei konnte nicht gefunden werden.The file described by the destinationBackupFileName parameter could not be found.

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.An I/O error occurred while opening the file.

- oder --or- Die Parameter sourceFileName und destinationFileName geben dieselbe Datei an.The sourceFileName and destinationFileName parameters specify the same file.

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.The specified path, file name, or both exceed the system-defined maximum length.

Das Betriebssystem ist Windows 98 Second Edition oder früher, und das Dateisystem ist nicht NTFS.The operating system is Windows 98 Second Edition or earlier and the files system is not NTFS.

Der sourceFileName- oder destinationFileName-Parameter gibt eine schreibgeschützte Datei an.The sourceFileName or destinationFileName parameter specifies a file that is read-only.

- oder --or- Dieser Vorgang wird von der aktuellen Plattform nicht unterstützt.This operation is not supported on the current platform.

- oder --or- Die Quell- oder Zielparameter geben ein Verzeichnis anstelle einer Datei an.Source or destination parameters specify a directory instead of a file.

- oder --or- Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Beispiele

Im folgenden Codebeispiel wird die Replace Methode, um eine Datei durch eine andere Datei ersetzen, und erstellen Sie eine Sicherung der ersetzten Datei.The following code example uses the Replace method to replace a file with another file and create a backup of the replaced file.

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

        }
    }
}
Imports System
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 mit dem Inhalt einer anderen Datei.The Replace method replaces the contents of a specified file with the contents of another file. Es erstellt auch eine Sicherungskopie der Datei, die ersetzt wurde.It also creates a backup of the file that was replaced.

Wenn die sourceFileName und destinationFileName sind auf unterschiedlichen Volumes wird diese Methode eine Ausnahme ausgelöst.If the sourceFileName and destinationFileName are on different volumes, this method will raise an exception. Wenn die destinationBackupFileName ist auf ein anderes Volume aus der Quelldatei, die Sicherungsdatei gelöscht werden.If the destinationBackupFileName is on a different volume from the source file, the backup file will be deleted.

Übergeben Sie null auf die destinationBackupFileName -Parameters, wenn Sie nicht, erstellen Sie eine Sicherung der ersetzten Datei möchten.Pass null to the destinationBackupFileName parameter if you do not want to create a backup of the file being replaced.

Wenn die destinationBackupFileName bereits vorhanden ist es überschrieben werden mit dem Inhalt der destinationFileName Datei.If the destinationBackupFileName already exists it will be overwritten with the contents of the destinationFileName file.

Sicherheit

FileIOPermission
für die Berechtigung zum Schreiben von beschriebenen Datei der destinationBackupFileName -Parameters, wenn eine angegeben wurde.for permission to write to file described by the destinationBackupFileName parameter if one is specified. Security-Aktion: Bei Bedarf.Security action: Demand. Zugeordnete Enumeration: WriteAssociated enumeration: Write

Gilt für: