Partilhar via

File.Replace Método

  • Referência

Definição

Namespace:
System.IO
Assembly:
System.IO.FileSystem.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

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

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 métodos Replace 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)

Origem:
File.cs
Origem:
File.cs
Origem:
File.cs

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);
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 parâmetro destinationFileName ou destinationBackupFileName não é de uma forma legal.

ArgumentNullException

O parâmetro destinationFileName é 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 parâmetros sourceFileName e destinationFileName especificam o mesmo arquivo.

PathTooLongException

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

UnauthorizedAccessException

O parâmetro sourceFileName ou destinationFileName especifica um arquivo 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.

-ou

sourceFileName e destinationFileName especificar o mesmo diretório existente.

Exemplos

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

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

Comentários

O método Replace 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 o sourceFileName e destinationFileName estiverem em volumes diferentes, esse método gerará uma exceção. Se o destinationBackupFileName estiver em um volume diferente do arquivo de origem, o arquivo de backup será excluído.

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

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

Aplica-se a

Replace(String, String, String, Boolean)

Origem:
File.cs
Origem:
File.cs
Origem:
File.cs

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);
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 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 parâmetro destinationFileName ou destinationBackupFileName não é de uma forma legal.

ArgumentNullException

O parâmetro destinationFileName é 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 destinationFileName especificar o mesmo arquivo.

PathTooLongException

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

UnauthorizedAccessException

O parâmetro sourceFileName ou destinationFileName especifica um arquivo 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.

-ou

sourceFileName e destinationFileName especificar o mesmo diretório existente.

Exemplos

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

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

Comentários

O método Replace 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 o sourceFileName e destinationFileName estiverem em volumes diferentes, esse método gerará uma exceção. Se o destinationBackupFileName estiver em um volume diferente do arquivo de origem, o arquivo de backup será excluído.

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

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

Aplica-se a