Aracılığıyla paylaş

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

Replace yöntemleri, belirtilen dosyanın içeriğini başka bir dosyanın içeriğiyle değiştirir. Ayrıca değiştirilen dosyanın 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

destinationFileNametarafından belirtilen 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

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

ArgumentNullException

destinationFileName parametresi null.

DriveNotFoundException

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

FileNotFoundException

sourceFileName veya destinationFileName parametresi tarafından açıklanan dosya bulunamadı.

IOException

Dosya açılırken bir G/Ç hatası oluştu.

-veya-

sourceFileName ve destinationFileName parametreleri aynı dosyayı belirtir.

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi de sistem tanımlı uzunluk üst sınırını aşıyor.

UnauthorizedAccessException

sourceFileName veya 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ı 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 Replace yöntemini kullanır.

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

Replace yöntemi, belirtilen dosyanın içeriğini başka bir dosyanın içeriğiyle değiştirir. Ayrıca değiştirilen dosyanın yedeğini de 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 oluşturmak istemiyorsanız destinationBackupFileName parametresine null geçirin.

destinationBackupFileName zaten varsa, destinationFileName dosyasının içeriğiyle 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

destinationFileNametarafından belirtilen dosyanın yerini alan dosyanın adı.

destinationFileName
String

Değiştirilen dosyanın adı.

destinationBackupFileName
String

Yedekleme dosyasının adı.

ignoreMetadataErrors
Boolean

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 true; aksi takdirde false.

Özel durumlar

ArgumentException

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

ArgumentNullException

destinationFileName parametresi null.

DriveNotFoundException

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

FileNotFoundException

sourceFileName veya destinationFileName parametresi tarafından açıklanan dosya bulunamadı.

IOException

Dosya açılırken bir G/Ç hatası oluştu.

-veya-

sourceFileName ve destinationFileName aynı dosyayı belirtin.

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi de sistem tanımlı uzunluk üst sınırını aşıyor.

UnauthorizedAccessException

sourceFileName veya 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ı 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 Replace yöntemini kullanır.

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

Replace yöntemi, belirtilen dosyanın içeriğini başka bir dosyanın içeriğiyle değiştirir. Ayrıca değiştirilen dosyanın yedeğini de 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 oluşturmak istemiyorsanız destinationBackupFileName parametresine null geçirin.

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

Şunlara uygulanır