FileSystemProxy.CopyFile Metoda

Definice

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

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)

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

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

public void CopyFile(string sourceFileName, string destinationFileName);

member this.CopyFile : string * string -> unit

Public 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.	Postupy: Vytvoření kopie souboru ve stejném adresáři
Zkopírujte soubor do jiného adresáře.	Postupy: Vytvoření kopie souboru v jiném adresáři

Viz také

Platí pro

CopyFile(String, String, UIOption)

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

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

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

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

Public 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.	Postupy: Vytvoření kopie souboru ve stejném adresáři
Zkopírujte soubor do jiného adresáře.	Postupy: Vytvoření kopie souboru v jiném adresáři

Viz také

Platí pro

CopyFile(String, String, Boolean)

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

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

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

member this.CopyFile : string * string * bool -> unit

Public 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.	Postupy: Vytvoření kopie souboru ve stejném adresáři
Zkopírujte soubor do jiného adresáře.	Postupy: Vytvoření kopie souboru v jiném adresáři

Viz také

Platí pro

CopyFile(String, String, UIOption, UICancelOption)

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

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

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

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

Public 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.	Postupy: Vytvoření kopie souboru ve stejném adresáři
Zkopírujte soubor do jiného adresáře.	Postupy: Vytvoření kopie souboru v jiném adresáři

Viz také

Platí pro

Váš názor

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