File.Replace Метод

Определение

Пространство имен:: System.IO

Сборки:: netstandard.dll, System.Runtime.dll

Сборки:: netstandard.dll, System.IO.FileSystem.dll

Сборки:: netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll

Сборка:: System.IO.FileSystem.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Заменяет содержимое указанного файла содержимым другого файла, удаление исходного файла и создание резервной копии замененного файла.

Перегрузки

Имя	Описание
Replace(String, String, String)	Заменяет содержимое указанного файла содержимым другого файла, удаление исходного файла и создание резервной копии замененного файла.
Replace(String, String, String, Boolean)	Заменяет содержимое указанного файла содержимым другого файла, удалив исходный файл и создав резервную копию замененного файла, и при необходимости игнорирует ошибки слияния.

Replace(String, String, String)

Исходный код:: File.cs

Исходный код:: File.cs

Исходный код:: File.cs

Исходный код:: File.cs

Исходный код:: File.cs

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)

Параметры

sourceFileName: String

Имя файла, заменяющего указанный файл destinationFileName.

destinationFileName: String

Имя заменяемого файла.

destinationBackupFileName: String

Имя файла резервной копии.

Исключения

ArgumentException

Путь, destinationFileName описанный параметром, destinationBackupFileName не имеет юридической формы.

ArgumentNullException

Параметр destinationFileName имеет значение null.

DriveNotFoundException

Указан недопустимый диск.

FileNotFoundException

Не удалось найти файл, sourceFileName описанный или destinationFileName параметр.

IOException

При открытии файла произошла ошибка ввода-вывода.

–или–

Параметры sourceFileName указывают destinationFileName один и тот же файл.

PathTooLongException

Указанный путь, имя файла или оба превышают определенную системой максимальную длину.

UnauthorizedAccessException

Параметр sourceFileName или destinationFileName задает файл, доступный только для чтения.

–или–

Эта операция не поддерживается на текущей платформе.

–или–

Исходные или целевые параметры указывают каталог вместо файла.

–или–

Вызывающий объект не имеет требуемого разрешения.

-или

sourceFileName и destinationFileName укажите тот же существующий каталог.

Примеры

В следующем примере кода метод используется Replace для замены файла другим файлом и создания резервной копии замененного файла.

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

sourceFileName Если и destinationFileName находятся на разных томах, этот метод вызывает исключение. Если файл destinationBackupFileName находится в другом томе исходного файла, файл резервной копии будет удален.

Передайте null параметру destinationBackupFileName , если вы не хотите создать резервную копию заменяемого файла.

destinationBackupFileName Если он уже существует, он заменен содержимым destinationFileName файла.

Применяется к

Replace(String, String, String, Boolean)

Исходный код:: File.cs

Исходный код:: File.cs

Исходный код:: File.cs

Исходный код:: File.cs

Исходный код:: File.cs

Заменяет содержимое указанного файла содержимым другого файла, удалив исходный файл и создав резервную копию замененного файла, и при необходимости игнорирует ошибки слияния.

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)

Параметры

sourceFileName: String

Имя файла, заменяющего указанный файл destinationFileName.

destinationFileName: String

Имя заменяемого файла.

destinationBackupFileName: String

Имя файла резервной копии.

ignoreMetadataErrors: Boolean

true , чтобы игнорировать ошибки слияния (например, атрибуты и списки управления доступом) из замененного файла в файл замены; falseв противном случае .

Исключения

ArgumentException

Путь, destinationFileName описанный параметром, destinationBackupFileName не имеет юридической формы.

ArgumentNullException

Параметр destinationFileName имеет значение null.

DriveNotFoundException

Указан недопустимый диск.

FileNotFoundException

Не удалось найти файл, sourceFileName описанный или destinationFileName параметр.

IOException

При открытии файла произошла ошибка ввода-вывода.

–или–

sourceFileName и destinationFileName укажите тот же файл.

PathTooLongException

Указанный путь, имя файла или оба превышают определенную системой максимальную длину.

UnauthorizedAccessException

Параметр sourceFileName или destinationFileName задает файл, доступный только для чтения.

–или–

Эта операция не поддерживается на текущей платформе.

–или–

Исходные или целевые параметры указывают каталог вместо файла.

–или–

Вызывающий объект не имеет требуемого разрешения.

-или

sourceFileName и destinationFileName укажите тот же существующий каталог.

Примеры

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

Применяется к

Кері байланыс

Бет пайдалы болды ма?

File.Replace Метод

Определение

Перегрузки

Комментарии

Replace(String, String, String)

Параметры

Исключения

Примеры

Комментарии

Применяется к

Replace(String, String, String, Boolean)

Параметры

Исключения

Примеры

Комментарии

Применяется к