File.Copy Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Zkopíruje existující soubor do nového souboru.

Přetížení

Copy(String, String)	Zkopíruje existující soubor do nového souboru. Přepsání souboru se stejným názvem není povoleno.
Copy(String, String, Boolean)	Zkopíruje existující soubor do nového souboru. Přepsání souboru se stejným názvem je povoleno.

Copy(String, String)

Zdroj:

File.cs

Zkopíruje existující soubor do nového souboru. Přepsání souboru se stejným názvem není povoleno.

public:
 static void Copy(System::String ^ sourceFileName, System::String ^ destFileName);

public static void Copy (string sourceFileName, string destFileName);

static member Copy : string * string -> unit

Public Shared Sub Copy (sourceFileName As String, destFileName As String)

Parametry

sourceFileName

String

Soubor, který chcete zkopírovat.

destFileName

String

Název cílového souboru. Nemůže se jednat o adresář ani existující soubor.

Výjimky

UnauthorizedAccessException

Volající nemá požadované oprávnění.

ArgumentException

sourceFileName nebo destFileName je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků. Pomocí metody GetInvalidPathChars() můžete zadat dotaz na neplatné znaky.

-nebo-

sourceFileName nebo destFileName určuje adresář.

ArgumentNullException

sourceFileName nebo destFileName je null.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

DirectoryNotFoundException

Cesta zadaná v sourceFileName nebo destFileName je neplatná (například je na nemapované jednotce).

FileNotFoundException

sourceFileName nebyl nalezen.

IOException

destFileName existuje.

-nebo-

Došlo k vstupně-výstupní chybě.

NotSupportedException

sourceFileName nebo destFileName je v neplatném formátu.

Příklady

Následující příklad zkopíruje soubory do záložní složky C:\archives\2008. Používá dvě přetížení metody Copy následujícím způsobem:

• Nejprve používá přetížení metody File.Copy(String, String) ke kopírování textových souborů (.txt). Kód ukazuje, že toto přetížení neumožňuje přepisovat soubory, které byly již zkopírovány.

• Pak použije přetížení metody File.Copy(String, String, Boolean) ke kopírování obrázků (.jpg souborů). Kód ukazuje, že toto přetížení umožňuje přepsání souborů, které byly již zkopírovány.

string sourceDir = @"c:\current";
string backupDir = @"c:\archives\2008";

try
{
    string[] picList = Directory.GetFiles(sourceDir, "*.jpg");
    string[] txtList = Directory.GetFiles(sourceDir, "*.txt");

    // Copy picture files.
    foreach (string f in picList)
    {
        // Remove path from the file name.
        string fName = f.Substring(sourceDir.Length + 1);

        // Use the Path.Combine method to safely append the file name to the path.
        // Will overwrite if the destination file already exists.
        File.Copy(Path.Combine(sourceDir, fName), Path.Combine(backupDir, fName), true);
    }

    // Copy text files.
    foreach (string f in txtList)
    {

        // Remove path from the file name.
        string fName = f.Substring(sourceDir.Length + 1);

        try
        {
            // Will not overwrite if the destination file already exists.
            File.Copy(Path.Combine(sourceDir, fName), Path.Combine(backupDir, fName));
        }

        // Catch exception if the file was already copied.
        catch (IOException copyError)
        {
            Console.WriteLine(copyError.Message);
        }
    }

    // Delete source files that were copied.
    foreach (string f in txtList)
    {
        File.Delete(f);
    }
    foreach (string f in picList)
    {
        File.Delete(f);
    }
}

catch (DirectoryNotFoundException dirNotFound)
{
    Console.WriteLine(dirNotFound.Message);
}

let sourceDir = @"c:\current"
let backupDir = @"c:\archives\2008"

try
    let picList = Directory.GetFiles(sourceDir, "*.jpg")
    let txtList = Directory.GetFiles(sourceDir, "*.txt")

    // Copy picture files.
    for f in picList do
        // Remove path from the file name.
        let fName = f.Substring(sourceDir.Length + 1)

        // Use the Path.Combine method to safely append the file name to the path.
        // Will overwrite if the destination file already exists.
        File.Copy(Path.Combine(sourceDir, fName), Path.Combine(backupDir, fName), true)

    // Copy text files.
    for f in txtList do
        // Remove path from the file name.
        let fName = f.Substring(sourceDir.Length + 1)

        try
            // Will not overwrite if the destination file already exists.
            File.Copy(Path.Combine(sourceDir, fName), Path.Combine(backupDir, fName))

        // Catch exception if the file was already copied.
        with
        | :? IOException as copyError -> printfn $"{copyError.Message}"

    // Delete source files that were copied.
    for f in txtList do
        File.Delete f

    for f in picList do
        File.Delete f

// Catch exception if the file was already copied.
with
| :? DirectoryNotFoundException as dirNotFound -> printfn $"{dirNotFound.Message}"

Dim sourceDir As String = "c:\current"
Dim backupDir As String = "c:\archives\2008"

Try
    Dim picList As String() = Directory.GetFiles(sourceDir, "*.jpg")
    Dim txtList As String() = Directory.GetFiles(sourceDir, "*.txt")

    ' Copy picture files.
    For Each f As String In picList
        'Remove path from the file name.
        Dim fName As String = f.Substring(sourceDir.Length + 1)

        ' Use the Path.Combine method to safely append the file name to the path.
        ' Will overwrite if the destination file already exists.
        File.Copy(Path.Combine(sourceDir, fName), Path.Combine(backupDir, fName), True)
    Next

    ' Copy text files.
    For Each f As String In txtList

        'Remove path from the file name.
        Dim fName As String = f.Substring(sourceDir.Length + 1)

        Try
            ' Will not overwrite if the destination file already exists.
            File.Copy(Path.Combine(sourceDir, fName), Path.Combine(backupDir, fName))

            ' Catch exception if the file was already copied.
        Catch copyError As IOException
            Console.WriteLine(copyError.Message)
        End Try
    Next

    For Each f As String In txtList
        File.Delete(f)
    Next

    For Each f As String In picList
        File.Delete(f)
    Next

Catch dirNotFound As DirectoryNotFoundException
    Console.WriteLine(dirNotFound.Message)
End Try

Poznámky

Tato metoda je ekvivalentní přetížení metody Copy(String, String, Boolean) s parametrem overwrite nastaveným na false.

Parametry sourceFileName a destFileName mohou určovat relativní nebo absolutní informace o cestě. Relativní informace o cestě se interpretují jako relativní vzhledem k aktuálnímu pracovnímu adresáři. Aktuální pracovní adresář získáte pomocí Directory.GetCurrentDirectory metody. Tato metoda nepodporuje zástupné znaky v parametrech.

Atributy původního souboru se zachovají v zkopírovaných souborech.

Viz také

• Move(String, String)
• Move(String, String)
• soubor a streamování vstupně-výstupních
• čtení textu ze souboru
• Postupy: Zápis textu do souboru
• Postupy: Čtení a zápis do nově vytvořeného datového souboru

Copy(String, String, Boolean)

Zdroj:

File.cs

Zkopíruje existující soubor do nového souboru. Přepsání souboru se stejným názvem je povoleno.

public:
 static void Copy(System::String ^ sourceFileName, System::String ^ destFileName, bool overwrite);

public static void Copy (string sourceFileName, string destFileName, bool overwrite);

static member Copy : string * string * bool -> unit

Public Shared Sub Copy (sourceFileName As String, destFileName As String, overwrite As Boolean)

Parametry

sourceFileName

String

Soubor, který chcete zkopírovat.

destFileName

String

Název cílového souboru. Nemůže se jednat o adresář.

overwrite

Boolean

true, pokud by měl být cílový soubor nahrazen, pokud již existuje; jinak false.

Výjimky

UnauthorizedAccessException

Volající nemá požadované oprávnění.

-nebo-

destFileName je jen pro čtení.

-nebo-

overwrite je true, destFileName existuje a je skrytý, ale sourceFileName není skrytý.

ArgumentException

sourceFileName nebo destFileName je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků. Pomocí metody GetInvalidPathChars() můžete zadat dotaz na neplatné znaky.

-nebo-

sourceFileName nebo destFileName určuje adresář.

ArgumentNullException

sourceFileName nebo destFileName je null.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

DirectoryNotFoundException

Cesta zadaná v sourceFileName nebo destFileName je neplatná (například je na nemapované jednotce).

FileNotFoundException

sourceFileName nebyl nalezen.

IOException

destFileName existuje a overwrite je false.

-nebo-

Došlo k vstupně-výstupní chybě.

NotSupportedException

sourceFileName nebo destFileName je v neplatném formátu.

Příklady

Následující příklad zkopíruje soubory do záložní složky C:\archives\2008. Používá dvě přetížení metody Copy následujícím způsobem:

• Nejprve používá přetížení metody File.Copy(String, String) ke kopírování textových souborů (.txt). Kód ukazuje, že toto přetížení neumožňuje přepisovat soubory, které byly již zkopírovány.

Pak použije přetížení metody File.Copy(String, String, Boolean) ke kopírování obrázků (.jpg souborů). Kód ukazuje, že toto přetížení umožňuje přepsání souborů, které byly již zkopírovány.

string sourceDir = @"c:\current";
string backupDir = @"c:\archives\2008";

try
{
    string[] picList = Directory.GetFiles(sourceDir, "*.jpg");
    string[] txtList = Directory.GetFiles(sourceDir, "*.txt");

    // Copy picture files.
    foreach (string f in picList)
    {
        // Remove path from the file name.
        string fName = f.Substring(sourceDir.Length + 1);

        // Use the Path.Combine method to safely append the file name to the path.
        // Will overwrite if the destination file already exists.
        File.Copy(Path.Combine(sourceDir, fName), Path.Combine(backupDir, fName), true);
    }

    // Copy text files.
    foreach (string f in txtList)
    {

        // Remove path from the file name.
        string fName = f.Substring(sourceDir.Length + 1);

        try
        {
            // Will not overwrite if the destination file already exists.
            File.Copy(Path.Combine(sourceDir, fName), Path.Combine(backupDir, fName));
        }

        // Catch exception if the file was already copied.
        catch (IOException copyError)
        {
            Console.WriteLine(copyError.Message);
        }
    }

    // Delete source files that were copied.
    foreach (string f in txtList)
    {
        File.Delete(f);
    }
    foreach (string f in picList)
    {
        File.Delete(f);
    }
}

catch (DirectoryNotFoundException dirNotFound)
{
    Console.WriteLine(dirNotFound.Message);
}

let sourceDir = @"c:\current"
let backupDir = @"c:\archives\2008"

try
    let picList = Directory.GetFiles(sourceDir, "*.jpg")
    let txtList = Directory.GetFiles(sourceDir, "*.txt")

    // Copy picture files.
    for f in picList do
        // Remove path from the file name.
        let fName = f.Substring(sourceDir.Length + 1)

        // Use the Path.Combine method to safely append the file name to the path.
        // Will overwrite if the destination file already exists.
        File.Copy(Path.Combine(sourceDir, fName), Path.Combine(backupDir, fName), true)

    // Copy text files.
    for f in txtList do
        // Remove path from the file name.
        let fName = f.Substring(sourceDir.Length + 1)

        try
            // Will not overwrite if the destination file already exists.
            File.Copy(Path.Combine(sourceDir, fName), Path.Combine(backupDir, fName))

        // Catch exception if the file was already copied.
        with
        | :? IOException as copyError -> printfn $"{copyError.Message}"

    // Delete source files that were copied.
    for f in txtList do
        File.Delete f

    for f in picList do
        File.Delete f

// Catch exception if the file was already copied.
with
| :? DirectoryNotFoundException as dirNotFound -> printfn $"{dirNotFound.Message}"

Dim sourceDir As String = "c:\current"
Dim backupDir As String = "c:\archives\2008"

Try
    Dim picList As String() = Directory.GetFiles(sourceDir, "*.jpg")
    Dim txtList As String() = Directory.GetFiles(sourceDir, "*.txt")

    ' Copy picture files.
    For Each f As String In picList
        'Remove path from the file name.
        Dim fName As String = f.Substring(sourceDir.Length + 1)

        ' Use the Path.Combine method to safely append the file name to the path.
        ' Will overwrite if the destination file already exists.
        File.Copy(Path.Combine(sourceDir, fName), Path.Combine(backupDir, fName), True)
    Next

    ' Copy text files.
    For Each f As String In txtList

        'Remove path from the file name.
        Dim fName As String = f.Substring(sourceDir.Length + 1)

        Try
            ' Will not overwrite if the destination file already exists.
            File.Copy(Path.Combine(sourceDir, fName), Path.Combine(backupDir, fName))

            ' Catch exception if the file was already copied.
        Catch copyError As IOException
            Console.WriteLine(copyError.Message)
        End Try
    Next

    For Each f As String In txtList
        File.Delete(f)
    Next

    For Each f As String In picList
        File.Delete(f)
    Next

Catch dirNotFound As DirectoryNotFoundException
    Console.WriteLine(dirNotFound.Message)
End Try

Poznámky

Parametry sourceFileName a destFileName mohou určovat relativní nebo absolutní informace o cestě. Relativní informace o cestě se interpretují jako relativní vzhledem k aktuálnímu pracovnímu adresáři. Tato metoda nepodporuje zástupné znaky v parametrech.

Atributy původního souboru se zachovají v zkopírovaných souborech.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úkoly.

Viz také

• Move(String, String)
• Move(String, String)
• soubor a streamování vstupně-výstupních
• čtení textu ze souboru
• Postupy: Zápis textu do souboru
• Postupy: Čtení a zápis do nově vytvořeného datového souboru