File.Replace Método

Definição

Namespace:: System.IO

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Substitui o conteúdo de um arquivo especificado pelo conteúdo de outro arquivo, excluindo o arquivo original e criando um backup do arquivo substituído.

Sobrecargas

Nome	Description
Replace(String, String, String)	Substitui o conteúdo de um arquivo especificado pelo conteúdo de outro arquivo, excluindo o arquivo original e criando um backup do arquivo substituído.
Replace(String, String, String, Boolean)	Substitui o conteúdo de um arquivo especificado pelo conteúdo de outro arquivo, excluindo o arquivo original e criando um backup do arquivo substituído e, opcionalmente, ignora erros de mesclagem.

Comentários

Os Replace métodos substituem o conteúdo de um arquivo especificado pelo conteúdo de outro arquivo. Eles também criam um backup do arquivo que foi substituído.

Replace(String, String, String)

Substitui o conteúdo de um arquivo especificado pelo conteúdo de outro arquivo, excluindo o arquivo original e criando um backup do arquivo substituído.

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)

Parâmetros

sourceFileName: String

O nome de um arquivo que substitui o arquivo especificado por destinationFileName.

destinationFileName: String

O nome do arquivo que está sendo substituído.

destinationBackupFileName: String

O nome do arquivo de backup.

Exceções

ArgumentException

O caminho descrito pelo destinationFileName parâmetro ou não destinationBackupFileName é de um formulário legal.

ArgumentNullException

O destinationFileName parâmetro é null.

DriveNotFoundException

Uma unidade inválida foi especificada.

FileNotFoundException

Não foi possível encontrar o arquivo descrito por sourceFileName ou destinationFileName parâmetro.

IOException

Ocorreu um erro de E/S ao abrir o arquivo.

-ou-

Os sourceFileName parâmetros e especifiquem destinationFileName o mesmo arquivo.

PathTooLongException

O caminho especificado, o nome do arquivo ou ambos excedem o comprimento máximo definido pelo sistema.

UnauthorizedAccessException

O sourceFileName parâmetro ou destinationFileName especifica um arquivo que é somente leitura.

-ou-

Não há suporte para essa operação na plataforma atual.

-ou-

Parâmetros de origem ou destino especificam um diretório em vez de um arquivo.

-ou-

O chamador não tem a permissão necessária.

-or

sourceFileName e especifique destinationFileName o mesmo diretório existente.

Exemplos

O exemplo de código a seguir usa o Replace método para substituir um arquivo por outro arquivo e criar um backup do arquivo substituído.

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

Comentários

O Replace método substitui o conteúdo de um arquivo especificado pelo conteúdo de outro arquivo. Ele também cria um backup do arquivo que foi substituído.

Se estiver sourceFileNamedestinationFileName em volumes diferentes, esse método gerará uma exceção. Se estiver destinationBackupFileName em um volume diferente do arquivo de origem, o arquivo de backup será excluído.

Passe null para o destinationBackupFileName parâmetro se você não quiser criar um backup do arquivo que está sendo substituído.

Se já destinationBackupFileName existir, ele será substituído pelo conteúdo do destinationFileName arquivo.

Aplica-se a

Replace(String, String, String, Boolean)

Substitui o conteúdo de um arquivo especificado pelo conteúdo de outro arquivo, excluindo o arquivo original e criando um backup do arquivo substituído e, opcionalmente, ignora erros de mesclagem.

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)

Parâmetros

sourceFileName: String

O nome de um arquivo que substitui o arquivo especificado por destinationFileName.

destinationFileName: String

O nome do arquivo que está sendo substituído.

destinationBackupFileName: String

O nome do arquivo de backup.

ignoreMetadataErrors: Boolean

true para ignorar erros de mesclagem (como atributos e ACLs (listas de controle de acesso)) do arquivo substituído para o arquivo de substituição; caso contrário, false.

Exceções

ArgumentException

O caminho descrito pelo destinationFileName parâmetro ou não destinationBackupFileName é de um formulário legal.

ArgumentNullException

O destinationFileName parâmetro é null.

DriveNotFoundException

Uma unidade inválida foi especificada.

FileNotFoundException

Não foi possível encontrar o arquivo descrito por sourceFileName ou destinationFileName parâmetro.

IOException

Ocorreu um erro de E/S ao abrir o arquivo.

-ou-

sourceFileName e especifique destinationFileName o mesmo arquivo.

PathTooLongException

O caminho especificado, o nome do arquivo ou ambos excedem o comprimento máximo definido pelo sistema.

UnauthorizedAccessException

O sourceFileName parâmetro ou destinationFileName especifica um arquivo que é somente leitura.

-ou-

Não há suporte para essa operação na plataforma atual.

-ou-

Parâmetros de origem ou destino especificam um diretório em vez de um arquivo.

-ou-

O chamador não tem a permissão necessária.

-or

sourceFileName e especifique destinationFileName o mesmo diretório existente.

Exemplos

O exemplo de código a seguir usa o Replace método para substituir um arquivo por outro arquivo e criar um backup do arquivo substituído.

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

Comentários

O Replace método substitui o conteúdo de um arquivo especificado pelo conteúdo de outro arquivo. Ele também cria um backup do arquivo que foi substituído.

Passe null para o destinationBackupFileName parâmetro se você não quiser criar um backup do arquivo que está sendo substituído.

Se já destinationBackupFileName existir, ele será substituído pelo conteúdo do destinationFileName arquivo.

Aplica-se a

Comentários

Esta página foi útil?