FileSystem.CopyFile Metoda

Definice

Obor názvů:: Microsoft.VisualBasic.FileIO

Sestavení:: Microsoft.VisualBasic.Core.dll

Sestavení:: Microsoft.VisualBasic.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zkopíruje soubor do nového umístění.

Přetížení

Name	Description
CopyFile(String, String)	Zkopíruje soubor do nového umístění.
CopyFile(String, String, UIOption)	Zkopíruje soubor do nového umístění.
CopyFile(String, String, Boolean)	Zkopíruje soubor do nového umístění.
CopyFile(String, String, UIOption, UICancelOption)	Zkopíruje soubor do nového umístění.

CopyFile(String, String)

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zkopíruje soubor do nového umístění.

public:
 static void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName);

public static void CopyFile(string sourceFileName, string destinationFileName);

static member CopyFile : string * string -> unit

Public Shared Sub CopyFile (sourceFileName As String, destinationFileName As String)

Parametry

sourceFileName: String

Soubor, který se má zkopírovat.

destinationFileName: String

Umístění, do kterého se má soubor zkopírovat.

Výjimky

ArgumentException

destinationFileName obsahuje informace o cestě.

ArgumentNullException

destinationFileName nebo je nebo sourceFileName je Nothing prázdný řetězec.

FileNotFoundException

Zdrojový soubor není platný nebo neexistuje.

IOException

Používá se soubor v cílovém adresáři se stejným názvem.

NotSupportedException

Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

PathTooLongException

Cesta překračuje maximální délku definovanou systémem.

UnauthorizedAccessException

Uživatel nemá požadovaná oprávnění.

SecurityException

Uživatel nemá potřebná oprávnění k zobrazení cesty.

Příklady

Tento příklad zkopíruje soubor Test.txt do adresáře TestFiles2 bez přepsání existujících souborů.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Cesty k souborům nahraďte cestami, které chcete použít v kódu.

Tento příklad zkopíruje soubor Test.txt do adresáře TestFiles2 a přejmenuje ho NewFile.txt.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Cesty k souborům nahraďte cestami, které chcete použít v kódu.

Poznámky

CopyFile nezachovává acE (položky Access Control). Nově vytvořený soubor dědí výchozí ACL z adresáře, ve kterém se vytvoří.

Následující tabulka uvádí příklady úkolů zahrnujících metodu My.Computer.FileSystem.CopyFile .

To	Podívejte se
Zkopírujte soubor do stejného adresáře.	: Vytvoření kopie souboru ve stejném adresáři v Visual Basic
Zkopírujte soubor do jiného adresáře.	W: Vytvoření kopie souboru v jiném adresáři v Visual Basic

Viz také

UICancelOption

Platí pro

CopyFile(String, String, UIOption)

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zkopíruje soubor do nového umístění.

public:
 static void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);

public static void CopyFile(string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);

static member CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit

Public Shared Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

Parametry

sourceFileName: String

Soubor, který se má zkopírovat.

destinationFileName: String

Umístění, do kterého se má soubor zkopírovat.

showUI: UIOption

Zda chcete vizuálně sledovat průběh operace. Výchozí hodnota je UIOption.OnlyErrorDialogs.

Výjimky

ArgumentException

destinationFileName obsahuje informace o cestě.

ArgumentNullException

destinationFileName nebo je nebo sourceFileName je Nothing prázdný řetězec.

FileNotFoundException

Zdrojový soubor není platný nebo neexistuje.

IOException

Cílový soubor existuje a overwrite je nastavený na Falsehodnotu .

NotSupportedException

Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

PathTooLongException

Cesta překračuje maximální délku definovanou systémem.

UnauthorizedAccessException

Uživatel nemá požadovaná oprávnění.

SecurityException

Uživatel nemá potřebná oprávnění k zobrazení cesty.

Příklady

Tento příklad zkopíruje soubor Test.txt do adresáře TestFiles2 bez přepsání existujících souborů.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Cesty k souborům nahraďte cestami, které chcete použít v kódu.

Tento příklad zkopíruje soubor Test.txt do adresáře TestFiles2 a přejmenuje ho NewFile.txt.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Cesty k souborům nahraďte cestami, které chcete použít v kódu.

Poznámky

CopyFile nezachovává acE (položky Access Control). Nově vytvořený soubor dědí výchozí ACL z adresáře, ve kterém se vytvoří.

Následující tabulka uvádí příklady úkolů zahrnujících metodu My.Computer.FileSystem.CopyFile .

To	Podívejte se
Zkopírujte soubor do stejného adresáře.	: Vytvoření kopie souboru ve stejném adresáři v Visual Basic
Zkopírujte soubor do jiného adresáře.	W: Vytvoření kopie souboru v jiném adresáři v Visual Basic

Viz také

UICancelOption

Platí pro

CopyFile(String, String, Boolean)

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zkopíruje soubor do nového umístění.

public:
 static void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);

public static void CopyFile(string sourceFileName, string destinationFileName, bool overwrite);

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

Public Shared Sub CopyFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

Parametry

sourceFileName: String

Soubor, který se má zkopírovat.

destinationFileName: String

Umístění, do kterého se má soubor zkopírovat.

overwrite: Boolean

True pokud by existující soubory měly být přepsány; jinak False. Výchozí hodnota je False.

Výjimky

ArgumentException

destinationFileName obsahuje informace o cestě.

ArgumentNullException

destinationFileName nebo je nebo sourceFileName je Nothing prázdný řetězec.

FileNotFoundException

Zdrojový soubor není platný nebo neexistuje.

IOException

Cílový soubor existuje a overwrite je nastavený na Falsehodnotu .

NotSupportedException

Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

PathTooLongException

Cesta překračuje maximální délku definovanou systémem.

UnauthorizedAccessException

Uživatel nemá požadovaná oprávnění.

SecurityException

Uživatel nemá potřebná oprávnění k zobrazení cesty.

Příklady

Tento příklad zkopíruje soubor Test.txt do adresáře TestFiles2 bez přepsání existujících souborů.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Cesty k souborům nahraďte cestami, které chcete použít v kódu.

Tento příklad zkopíruje soubor Test.txt do adresáře TestFiles2 a přejmenuje ho NewFile.txt.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Cesty k souborům nahraďte cestami, které chcete použít v kódu.

Poznámky

CopyFile nezachovává acE (položky Access Control). Nově vytvořený soubor dědí výchozí ACL z adresáře, ve kterém se vytvoří.

Následující tabulka uvádí příklady úkolů zahrnujících metodu My.Computer.FileSystem.CopyFile .

To	Podívejte se
Zkopírujte soubor do stejného adresáře.	: Vytvoření kopie souboru ve stejném adresáři v Visual Basic
Zkopírujte soubor do jiného adresáře.	W: Vytvoření kopie souboru v jiném adresáři v Visual Basic

Viz také

UICancelOption

Platí pro

CopyFile(String, String, UIOption, UICancelOption)

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zdroj:: FileSystem.vb

Zkopíruje soubor do nového umístění.

public:
 static void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public static void CopyFile(string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

static member CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Shared Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)

Parametry

sourceFileName: String

Soubor, který se má zkopírovat.

destinationFileName: String

Umístění, do kterého se má soubor zkopírovat.

showUI: UIOption

Zda chcete vizuálně sledovat průběh operace. Výchozí hodnota je UIOption.OnlyErrorDialogs.

onUserCancel: UICancelOption

Určuje, co se má udělat, pokud uživatel během operace klikne na tlačítko Storno . Výchozí hodnota je ThrowException.

Výjimky

ArgumentException

destinationFileName obsahuje informace o cestě.

ArgumentNullException

destinationFileName nebo je nebo sourceFileName je Nothing prázdný řetězec.

FileNotFoundException

Zdrojový soubor není platný nebo neexistuje.

IOException

Cílový soubor existuje a overwrite je nastavený na Falsehodnotu .

NotSupportedException

Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

PathTooLongException

Cesta překračuje maximální délku definovanou systémem.

UnauthorizedAccessException

Uživatel nemá požadovaná oprávnění.

SecurityException

Uživatel nemá potřebná oprávnění k zobrazení cesty.

OperationCanceledException

UICancelOption je nastavena na ThrowExceptionhodnotu a uživatel zrušil operaci nebo dojde k nezadané vstupně-výstupní chybě.

Příklady

Tento příklad zkopíruje soubor Test.txt do adresáře TestFiles2 bez přepsání existujících souborů.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Cesty k souborům nahraďte cestami, které chcete použít v kódu.

Tento příklad zkopíruje soubor Test.txt do adresáře TestFiles2 a přejmenuje ho NewFile.txt.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Cesty k souborům nahraďte cestami, které chcete použít v kódu.

Poznámky

CopyFile nezachovává acE (položky Access Control). Nově vytvořený soubor dědí výchozí ACL z adresáře, ve kterém se vytvoří.

Následující tabulka uvádí příklady úkolů zahrnujících metodu My.Computer.FileSystem.CopyFile .

To	Podívejte se
Zkopírujte soubor do stejného adresáře.	: Vytvoření kopie souboru ve stejném adresáři v Visual Basic
Zkopírujte soubor do jiného adresáře.	W: Vytvoření kopie souboru v jiném adresáři v Visual Basic

Viz také

UICancelOption

Platí pro

Váš názor

Byla tato stránka užitečná?