FileInfo.Replace Metodo

Definizione

Spazio dei nomi:: System.IO

Assembly:: netstandard.dll, System.Runtime.dll

Assembly:: netstandard.dll, System.IO.FileSystem.dll

Assembly:: netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll

Assembly:: System.IO.FileSystem.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Sostituisce il contenuto di un file specificato con il file descritto dall'oggetto corrente FileInfo , eliminando il file originale e creando un backup del file sostituito.

Overload

Nome	Descrizione
Replace(String, String)	Sostituisce il contenuto di un file specificato con il file descritto dall'oggetto corrente FileInfo , eliminando il file originale e creando un backup del file sostituito.
Replace(String, String, Boolean)	Sostituisce il contenuto di un file specificato con il file descritto dall'oggetto corrente FileInfo , eliminando il file originale e creando un backup del file sostituito. Specifica inoltre se ignorare gli errori di merge.

Commenti

Utilizzare i Replace metodi quando è necessario sostituire rapidamente un file con il contenuto del file descritto dall'oggetto corrente FileInfo .

Replace(String, String)

Origine:: FileInfo.cs

Origine:: FileInfo.cs

Origine:: FileInfo.cs

Origine:: FileInfo.cs

Origine:: FileInfo.cs

Sostituisce il contenuto di un file specificato con il file descritto dall'oggetto corrente FileInfo , eliminando il file originale e creando un backup del file sostituito.

public:
 System::IO::FileInfo ^ Replace(System::String ^ destinationFileName, System::String ^ destinationBackupFileName);

public System.IO.FileInfo Replace(string destinationFileName, string? destinationBackupFileName);

public System.IO.FileInfo Replace(string destinationFileName, string destinationBackupFileName);

[System.Runtime.InteropServices.ComVisible(false)]
public System.IO.FileInfo Replace(string destinationFileName, string destinationBackupFileName);

member this.Replace : string * string -> System.IO.FileInfo

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Replace : string * string -> System.IO.FileInfo

Public Function Replace (destinationFileName As String, destinationBackupFileName As String) As FileInfo

Parametri

destinationFileName: String

Nome di un file da sostituire con il file corrente.

destinationBackupFileName: String

Nome di un file con cui creare un backup del file descritto dal destinationFileName parametro .

Valori restituiti

FileInfo

Oggetto FileInfo che incapsula informazioni sul file descritto dal destinationFileName parametro .

Attributi: ComVisibleAttribute

Eccezioni

ArgumentException

Il percorso descritto dal destinationFileName parametro non è valido.

oppure

Il percorso descritto dal destinationBackupFileName parametro non è valido.

ArgumentNullException

Il destinationFileName parametro è null.

FileNotFoundException

Impossibile trovare il file descritto dall'oggetto corrente FileInfo .

oppure

Impossibile trovare il destinationFileName file descritto dal parametro .

PlatformNotSupportedException

Il sistema operativo corrente non è Microsoft Windows NT o versione successiva.

Esempio

Nell'esempio seguente viene utilizzato il Replace metodo per sostituire un file con un altro file e creare un backup del file sostituito.

using System;
using System.IO;

namespace FileSystemExample
{
    class FileExample
    {
        public static void Main()
        {
            try
            {
                // originalFile and fileToReplace must contain the path to files that already exist in the
                // file system. backUpOfFileToReplace is created during the execution of the Replace method.

                string originalFile  = "test.txt";
                string fileToReplace = "test2.txt";
                string backUpOfFileToReplace = "test2.txt.bak";

                if (File.Exists(originalFile) && (File.Exists(fileToReplace)))
                {
                    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");
                }
                else
                {
                    Console.WriteLine("Either the file {0} or {1} doesn't " + "exist.", originalFile, fileToReplace);
                }
            }
            catch (Exception e)
            {
                Console.WriteLine(e.Message);
            }

            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)
        {
            // Create a new FileInfo object.
            FileInfo fInfo = new FileInfo(fileToMoveAndDelete);

            // replace the file.
            fInfo.Replace(fileToReplace, backupOfFileToReplace, false);
        }
    }
}
//Move the contents of test.txt into test2.txt, delete test.txt, and
//create a backup of test2.txt.
//Done

Imports System.IO

Module FileExample

    Sub Main()
        Try
            ' originalFile and fileToReplace must contain the path to files that already exist in the  
            ' file system. backUpOfFileToReplace is created during the execution of the Replace method.

            Dim originalFile As String = "test.xml"
            Dim fileToReplace As String = "test2.xml"
            Dim backUpOfFileToReplace As String = "test2.xml.bak"

            If (File.Exists(originalFile) And (File.Exists(fileToReplace))) Then
                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")

            Else
                Console.WriteLine("Either the file {0} or {1} doesn't " + "exist.", originalFile, fileToReplace)
            End If
        Catch e As Exception
            Console.WriteLine(e.Message)
        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)
        ' Create a new FileInfo object.
        Dim fInfo As New FileInfo(fileToMoveAndDelete)

        ' Replace the file.
        fInfo.Replace(fileToReplace, backupOfFileToReplace, False)

    End Sub
End Module

' Move the contents of test.txt into test2.txt, delete test.txt, and 
' create a backup of test2.txt.
' Done

Commenti

Il Replace metodo sostituisce il contenuto di un file specificato con il contenuto del file descritto dall'oggetto corrente FileInfo . Crea anche un backup del file sostituito. Restituisce infine un nuovo FileInfo oggetto che descrive il file sovrascritto.

Passare null al destinationBackupFileName parametro se non si vuole creare un backup del file da sostituire.

Si applica a

Replace(String, String, Boolean)

Origine:: FileInfo.cs

Origine:: FileInfo.cs

Origine:: FileInfo.cs

Origine:: FileInfo.cs

Origine:: FileInfo.cs

Sostituisce il contenuto di un file specificato con il file descritto dall'oggetto corrente FileInfo , eliminando il file originale e creando un backup del file sostituito. Specifica inoltre se ignorare gli errori di merge.

public:
 System::IO::FileInfo ^ Replace(System::String ^ destinationFileName, System::String ^ destinationBackupFileName, bool ignoreMetadataErrors);

public System.IO.FileInfo Replace(string destinationFileName, string? destinationBackupFileName, bool ignoreMetadataErrors);

public System.IO.FileInfo Replace(string destinationFileName, string destinationBackupFileName, bool ignoreMetadataErrors);

[System.Runtime.InteropServices.ComVisible(false)]
public System.IO.FileInfo Replace(string destinationFileName, string destinationBackupFileName, bool ignoreMetadataErrors);

member this.Replace : string * string * bool -> System.IO.FileInfo

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Replace : string * string * bool -> System.IO.FileInfo

Public Function Replace (destinationFileName As String, destinationBackupFileName As String, ignoreMetadataErrors As Boolean) As FileInfo

Parametri

destinationFileName: String

Nome di un file da sostituire con il file corrente.

destinationBackupFileName: String

Nome di un file con cui creare un backup del file descritto dal destinationFileName parametro .

ignoreMetadataErrors: Boolean

true per ignorare gli errori di unione (ad esempio attributi e ACL) dal file sostituito al file di sostituzione; in caso contrario false, .

Valori restituiti

FileInfo

Oggetto FileInfo che incapsula informazioni sul file descritto dal destinationFileName parametro .

Attributi: ComVisibleAttribute

Eccezioni

ArgumentException

Il percorso descritto dal destinationFileName parametro non è valido.

oppure

Il percorso descritto dal destinationBackupFileName parametro non è valido.

ArgumentNullException

Il destinationFileName parametro è null.

FileNotFoundException

Impossibile trovare il file descritto dall'oggetto corrente FileInfo .

oppure

Impossibile trovare il destinationFileName file descritto dal parametro .

PlatformNotSupportedException

Il sistema operativo corrente non è Microsoft Windows NT o versione successiva.

Esempio

Nell'esempio seguente viene utilizzato il Replace metodo per sostituire un file con un altro file e creare un backup del file sostituito.

using System;
using System.IO;

namespace FileSystemExample
{
    class FileExample
    {
        public static void Main()
        {
            try
            {
                // originalFile and fileToReplace must contain the path to files that already exist in the
                // file system. backUpOfFileToReplace is created during the execution of the Replace method.

                string originalFile  = "test.txt";
                string fileToReplace = "test2.txt";
                string backUpOfFileToReplace = "test2.txt.bak";

                if (File.Exists(originalFile) && (File.Exists(fileToReplace)))
                {
                    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");
                }
                else
                {
                    Console.WriteLine("Either the file {0} or {1} doesn't " + "exist.", originalFile, fileToReplace);
                }
            }
            catch (Exception e)
            {
                Console.WriteLine(e.Message);
            }

            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)
        {
            // Create a new FileInfo object.
            FileInfo fInfo = new FileInfo(fileToMoveAndDelete);

            // replace the file.
            fInfo.Replace(fileToReplace, backupOfFileToReplace, false);
        }
    }
}
//Move the contents of test.txt into test2.txt, delete test.txt, and
//create a backup of test2.txt.
//Done

Imports System.IO

Module FileExample

    Sub Main()
        Try
            ' originalFile and fileToReplace must contain the path to files that already exist in the  
            ' file system. backUpOfFileToReplace is created during the execution of the Replace method.

            Dim originalFile As String = "test.xml"
            Dim fileToReplace As String = "test2.xml"
            Dim backUpOfFileToReplace As String = "test2.xml.bak"

            If (File.Exists(originalFile) And (File.Exists(fileToReplace))) Then
                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")

            Else
                Console.WriteLine("Either the file {0} or {1} doesn't " + "exist.", originalFile, fileToReplace)
            End If
        Catch e As Exception
            Console.WriteLine(e.Message)
        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)
        ' Create a new FileInfo object.
        Dim fInfo As New FileInfo(fileToMoveAndDelete)

        ' Replace the file.
        fInfo.Replace(fileToReplace, backupOfFileToReplace, False)

    End Sub
End Module

' Move the contents of test.txt into test2.txt, delete test.txt, and 
' create a backup of test2.txt.
' Done

Commenti

Passare null al destinationBackupFileName parametro se non si vuole creare un backup del file da sostituire.

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?