FileSystemProxy.CopyFile Metoda

Reference

Definice

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

Sestavení:: Microsoft.VisualBasic.dll

Sestavení:: Microsoft.VisualBasic.Forms.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í

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 sourceFileName je Nothing nebo 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)

Nahraďte cesty k souborům 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)

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

Poznámky

CopyFileneuchovává ACE (Access Control položky). Nově vytvořený soubor dědí výchozí funkce ACE z adresáře, ve kterém je vytvořen.

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

Záměr	Seznamte se s
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 se má vizuálně sledovat průběh operace. Výchozí je UIOption.OnlyErrorDialogs.

Výjimky

ArgumentException

destinationFileName obsahuje informace o cestě.

ArgumentNullException

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

FileNotFoundException

Zdrojový soubor není platný nebo neexistuje.

IOException

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

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)

Nahraďte cesty k souborům 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)

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

Poznámky

CopyFileneuchovává ACE (Access Control položky). Nově vytvořený soubor dědí výchozí funkce ACE z adresáře, ve kterém je vytvořen.

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

Záměr	Seznamte se s
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í je False.

Výjimky

ArgumentException

destinationFileName obsahuje informace o cestě.

ArgumentNullException

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

FileNotFoundException

Zdrojový soubor není platný nebo neexistuje.

IOException

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

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)

Nahraďte cesty k souborům 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)

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

Poznámky

CopyFileneuchovává ACE (Access Control položky). Nově vytvořený soubor dědí výchozí funkce ACE z adresáře, ve kterém je vytvořen.

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

Záměr	Seznamte se s
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 se má vizuálně sledovat průběh operace. Výchozí je UIOption.OnlyErrorDialogs.

onUserCancel: UICancelOption

Určuje, co se má udělat, když uživatel během operace klikne na Zrušit . Výchozí je ThrowException.

Výjimky

ArgumentException

destinationFileName obsahuje informace o cestě.

ArgumentNullException

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

FileNotFoundException

Zdrojový soubor není platný nebo neexistuje.

IOException

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

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 nastavená na ThrowExceptiona uživatel zrušil operaci nebo došlo k nespecifikované V/V 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)

Nahraďte cesty k souborům 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)

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

Poznámky

CopyFileneuchovává ACE (Access Control položky). Nově vytvořený soubor dědí výchozí funkce ACE z adresáře, ve kterém je vytvořen.

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

Záměr	Seznamte se s
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

Sdílet prostřednictvím

FileSystemProxy.CopyFile Metoda

Definice

Přetížení

CopyFile(String, String)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

CopyFile(String, String, UIOption)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

CopyFile(String, String, Boolean)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

CopyFile(String, String, UIOption, UICancelOption)

Parametry

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Další materiály