Share via

File.Replace Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.IO
Bütünleştirilmiş Kod:
System.IO.FileSystem.dll
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll

Belirtilen dosyanın içeriğini başka bir dosyanın içeriğiyle değiştirir, özgün dosyayı siler ve değiştirilen dosyanın yedeğini oluşturur.

Aşırı Yüklemeler

Replace(String, String, String)

Belirtilen dosyanın içeriğini başka bir dosyanın içeriğiyle değiştirir, özgün dosyayı siler ve değiştirilen dosyanın yedeğini oluşturur.
Replace(String, String, String, Boolean)

Belirtilen dosyanın içeriğini başka bir dosyanın içeriğiyle değiştirir, özgün dosyayı siler ve değiştirilen dosyanın yedeğini oluşturur ve isteğe bağlı olarak birleştirme hatalarını yoksayar.

Açıklamalar

Yöntemler, Replace belirtilen dosyanın içeriğini başka bir dosyanın içeriğiyle değiştirir. Ayrıca değiştirilen dosyanın bir yedeğini de oluştururlar.

Replace(String, String, String)

Kaynak:
File.cs
Kaynak:
File.cs
Kaynak:
File.cs

Belirtilen dosyanın içeriğini başka bir dosyanın içeriğiyle değiştirir, özgün dosyayı siler ve değiştirilen dosyanın yedeğini oluşturur.

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)

Parametreler

sourceFileName
String

tarafından destinationFileNamebelirtilen dosyanın yerini alan dosyanın adı.

destinationFileName
String

Değiştirilen dosyanın adı.

destinationBackupFileName
String

Yedekleme dosyasının adı.

Özel durumlar

ArgumentException

parametresi tarafından destinationFileName açıklanan yol yasal bir biçimde değildi.

-veya-

parametresi tarafından destinationBackupFileName açıklanan yol yasal bir biçimde değildi.

ArgumentNullException

destinationFileName parametresidirnull.

DriveNotFoundException

Geçersiz bir sürücü belirtildi.

FileNotFoundException

Geçerli FileInfo nesne tarafından açıklanan dosya bulunamadı.

-veya-

parametresi tarafından destinationBackupFileName açıklanan dosya bulunamadı.

IOException

Dosyayı açarken bir G/Ç hatası oluştu.

-veya-

sourceFileName ve destinationFileName parametreleri aynı dosyayı belirtir.

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.

UnauthorizedAccessException

sourceFileName or destinationFileName parametresi salt okunur bir dosya belirtir.

-veya-

Bu işlem geçerli platformda desteklenmiyor.

-veya-

Kaynak veya hedef parametreler dosya yerine bir dizin belirtir.

-veya-

Çağıranın gerekli izni yok.

-Veya

sourceFileName ve destinationFileName aynı mevcut dizini belirtin.

Örnekler

Aşağıdaki kod örneği, bir dosyayı başka bir dosyayla değiştirmek ve değiştirilen dosyanın yedeğini oluşturmak için yöntemini kullanır Replace .

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

Açıklamalar

yöntemi, Replace belirtilen dosyanın içeriğini başka bir dosyanın içeriğiyle değiştirir. Ayrıca değiştirilen dosyanın bir yedeğini oluşturur.

sourceFileName ve destinationFileName farklı birimlerdeyse, bu yöntem bir özel durum oluşturur. destinationBackupFileName kaynak dosyadan farklı bir birimdeyse, yedekleme dosyası silinir.

Değiştirilen dosyanın yedeğini destinationBackupFileName oluşturmak istemiyorsanız parametresine geçinnull.

destinationBackupFileName zaten varsa, dosyanın içeriğiyle destinationFileName değiştirilir.

Şunlara uygulanır

Replace(String, String, String, Boolean)

Kaynak:
File.cs
Kaynak:
File.cs
Kaynak:
File.cs

Belirtilen dosyanın içeriğini başka bir dosyanın içeriğiyle değiştirir, özgün dosyayı siler ve değiştirilen dosyanın yedeğini oluşturur ve isteğe bağlı olarak birleştirme hatalarını yoksayar.

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)

Parametreler

sourceFileName
String

tarafından destinationFileNamebelirtilen dosyanın yerini alan dosyanın adı.

destinationFileName
String

Değiştirilen dosyanın adı.

destinationBackupFileName
String

Yedekleme dosyasının adı.

ignoreMetadataErrors
Boolean

true değiştirilen dosyadan değiştirme dosyasına birleştirme hatalarını (öznitelikler ve erişim denetim listeleri (ACL' ler) gibi) yoksaymak için; aksi takdirde , false.

Özel durumlar

ArgumentException

parametresi tarafından destinationFileName açıklanan yol yasal bir biçimde değildi.

-veya-

parametresi tarafından destinationBackupFileName açıklanan yol yasal bir biçimde değildi.

ArgumentNullException

destinationFileName parametresidirnull.

DriveNotFoundException

Geçersiz bir sürücü belirtildi.

FileNotFoundException

Geçerli FileInfo nesne tarafından açıklanan dosya bulunamadı.

-veya-

parametresi tarafından destinationBackupFileName açıklanan dosya bulunamadı.

IOException

Dosyayı açarken bir G/Ç hatası oluştu.

-veya-

sourceFileName ve destinationFileName parametreleri aynı dosyayı belirtir.

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.

UnauthorizedAccessException

sourceFileName or destinationFileName parametresi salt okunur bir dosya belirtir.

-veya-

Bu işlem geçerli platformda desteklenmiyor.

-veya-

Kaynak veya hedef parametreler dosya yerine bir dizin belirtir.

-veya-

Çağıranın gerekli izni yok.

-Veya

sourceFileName ve destinationFileName aynı mevcut dizini belirtin.

Örnekler

Aşağıdaki kod örneği, bir dosyayı başka bir dosyayla değiştirmek ve değiştirilen dosyanın yedeğini oluşturmak için yöntemini kullanır Replace .

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

Açıklamalar

yöntemi, Replace belirtilen dosyanın içeriğini başka bir dosyanın içeriğiyle değiştirir. Ayrıca değiştirilen dosyanın bir yedeğini oluşturur.

sourceFileName ve destinationFileName farklı birimlerdeyse, bu yöntem bir özel durum oluşturur. destinationBackupFileName kaynak dosyadan farklı bir birimdeyse, yedekleme dosyası silinir.

Değiştirilen dosyanın yedeğini destinationBackupFileName oluşturmak istemiyorsanız parametresine geçinnull.

destinationBackupFileName zaten varsa, dosyanın içeriğiyle destinationFileName değiştirilir.

Şunlara uygulanır