File.Replace Método

Definição

Espaço de Nomes:: System.IO

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Substitui o conteúdo de um ficheiro especificado pelo conteúdo de outro ficheiro, eliminando o ficheiro original e criando uma cópia de segurança do ficheiro substituído.

Sobrecargas

Name	Description
Replace(String, String, String)	Substitui o conteúdo de um ficheiro especificado pelo conteúdo de outro ficheiro, eliminando o ficheiro original e criando uma cópia de segurança do ficheiro substituído.
Replace(String, String, String, Boolean)	Substitui o conteúdo de um ficheiro especificado pelo conteúdo de outro ficheiro, eliminando o ficheiro original e criando uma cópia de segurança do ficheiro substituído, e opcionalmente ignora erros de fusão.

Observações

Os Replace métodos substituem o conteúdo de um ficheiro especificado pelo conteúdo de outro ficheiro. Também criam uma cópia de segurança do ficheiro que foi substituído.

Replace(String, String, String)

Substitui o conteúdo de um ficheiro especificado pelo conteúdo de outro ficheiro, eliminando o ficheiro original e criando uma cópia de segurança do ficheiro 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 ficheiro que substitui o ficheiro especificado por destinationFileName.

destinationFileName: String

O nome do ficheiro a ser substituído.

destinationBackupFileName: String

O nome do ficheiro de backup.

Exceções

ArgumentException

O caminho descrito pelo destinationFileName parâmetro ou destinationBackupFileName não é de forma legal.

ArgumentNullException

O destinationFileName parâmetro é null.

DriveNotFoundException

Foi especificado um disco inválido.

FileNotFoundException

O ficheiro descrito por sourceFileName ou destinationFileName parâmetro não foi encontrado.

IOException

Ocorreu um erro de E/S durante a abertura do ficheiro.

-ou-

Os sourceFileName parâmetros e destinationFileName especificam o mesmo ficheiro.

PathTooLongException

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

UnauthorizedAccessException

O sourceFileName parâmetro ou destinationFileName especifica um ficheiro que é apenas de leitura.

-ou-

Esta operação não é suportada na plataforma atual.

-ou-

Os parâmetros de origem ou destino especificam um diretório em vez de um ficheiro.

-ou-

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

-ou

sourceFileName e destinationFileName especificar o mesmo diretório existente.

Exemplos

O exemplo de código seguinte utiliza o Replace método para substituir um ficheiro por outro e criar uma cópia de segurança do ficheiro 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

Observações

O Replace método substitui o conteúdo de um ficheiro especificado pelo conteúdo de outro ficheiro. Também cria uma cópia de segurança do ficheiro que foi substituído.

Se os sourceFileName e destinationFileName estiverem em volumes diferentes, este método levanta uma exceção. Se estiver destinationBackupFileName num volume diferente do ficheiro de origem, o ficheiro de backup será eliminado.

Passa null para o destinationBackupFileName parâmetro se não quiseres criar uma cópia de segurança do ficheiro a substituir.

Se já existir destinationBackupFileName , é substituído pelo conteúdo do destinationFileName ficheiro.

Aplica-se a

Replace(String, String, String, Boolean)

Substitui o conteúdo de um ficheiro especificado pelo conteúdo de outro ficheiro, eliminando o ficheiro original e criando uma cópia de segurança do ficheiro substituído, e opcionalmente ignora erros de fusão.

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 ficheiro que substitui o ficheiro especificado por destinationFileName.

destinationFileName: String

O nome do ficheiro a ser substituído.

destinationBackupFileName: String

O nome do ficheiro de backup.

ignoreMetadataErrors: Boolean

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

Exceções

ArgumentException

O caminho descrito pelo destinationFileName parâmetro ou destinationBackupFileName não é de forma legal.

ArgumentNullException

O destinationFileName parâmetro é null.

DriveNotFoundException

Foi especificado um disco inválido.

FileNotFoundException

O ficheiro descrito por sourceFileName ou destinationFileName parâmetro não foi encontrado.

IOException

Ocorreu um erro de E/S durante a abertura do ficheiro.

-ou-

sourceFileName e destinationFileName especificar o mesmo ficheiro.

PathTooLongException

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

UnauthorizedAccessException

O sourceFileName parâmetro ou destinationFileName especifica um ficheiro que é apenas de leitura.

-ou-

Esta operação não é suportada na plataforma atual.

-ou-

Os parâmetros de origem ou destino especificam um diretório em vez de um ficheiro.

-ou-

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

-ou

sourceFileName e destinationFileName especificar o mesmo diretório existente.

Exemplos

O exemplo de código seguinte utiliza o Replace método para substituir um ficheiro por outro e criar uma cópia de segurança do ficheiro 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

Observações

O Replace método substitui o conteúdo de um ficheiro especificado pelo conteúdo de outro ficheiro. Também cria uma cópia de segurança do ficheiro que foi substituído.

Passa null para o destinationBackupFileName parâmetro se não quiseres criar uma cópia de segurança do ficheiro a substituir.

Se já existir destinationBackupFileName , é substituído pelo conteúdo do destinationFileName ficheiro.

Aplica-se a

Comentários

Esta página foi útil?