FileSystemProxy.CopyDirectory Metoda
Definice
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 adresář do jiného adresáře.
Přetížení
| CopyDirectory(String, String) |
Zkopíruje adresář do jiného adresáře. |
| CopyDirectory(String, String, UIOption) |
Zkopíruje adresář do jiného adresáře. |
| CopyDirectory(String, String, Boolean) |
Zkopíruje adresář do jiného adresáře. |
| CopyDirectory(String, String, UIOption, UICancelOption) |
Zkopíruje adresář do jiného adresáře. |
CopyDirectory(String, String)
Zkopíruje adresář do jiného adresáře.
public:
void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName);public void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName);member this.CopyDirectory : string * string -> unitPublic Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String)Parametry
- sourceDirectoryName
- String
Adresář, který se má zkopírovat.
- destinationDirectoryName
- String
Umístění, do kterého se má adresář zkopírovat.
Výjimky
Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; nebo se jedná o cestu k zařízení (začíná na \\.\).
destinationDirectoryName nebo sourceDirectoryName je Nothing nebo prázdný řetězec.
Zdrojový adresář neexistuje.
Zdrojová a cílová cesta jsou stejné.
Operace je cyklická.
Cesta přesahuje systémem definovanou maximální délku.
Název složky v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.
Uživatel nemá potřebná oprávnění k zobrazení cesty.
Cílový soubor existuje, ale nelze k němu získat přístup.
Příklady
Následující příklad zkopíruje adresář TestDirectory1 do TestDirectory2a přepíše existující soubory.
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
Nahraďte C:\TestDirectory1 a C:\TestDirectory2 cestou a názvem adresáře, který chcete zkopírovat, a umístěním, do kterého ho chcete zkopírovat.
Poznámky
Tato metoda zkopíruje obsah adresáře i samotný adresář. Pokud cílový adresář neexistuje, vytvoří se. Pokud v cílovém umístění existuje adresář se stejným názvem, obsah těchto dvou adresářů se sloučí. Během operace můžete zadat nový název adresáře.
Při kopírování souborů v adresáři může dojít k výjimkám způsobeným konkrétním souborem. Při vyvolání takových výjimek jsou konsolidovány do jediné výjimky, jejíž Data vlastnost obsahuje položky ve formě IDictionary , ve kterém je cesta k souboru nebo adresáři klíčem a konkrétní zpráva o výjimce je obsažena v odpovídající hodnotě. Slouží For…Each k vytvoření výčtu položek.
Následující tabulka uvádí příklady úloh zahrnujících metodu My.Computer.FileSystem.CopyDirectory .
| Záměr | Seznamte se s |
|---|---|
| Kopírování adresáře | Postupy: Zkopírování adresáře do jiného adresáře |
Viz také
- UICancelOption
- Objekty (Visual Basic)
- Postupy: Získání kolekce souborů z adresáře v jazyce Visual Basic
- Postupy: Analýza cest k souborům v jazyce Visual Basic
Platí pro
CopyDirectory(String, String, UIOption)
Zkopíruje adresář do jiného adresáře.
public:
void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI);public void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI);member this.CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unitPublic Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption)Parametry
- sourceDirectoryName
- String
Adresář, který se má zkopírovat.
- destinationDirectoryName
- String
Umístění, do kterého se má adresář zkopírovat.
- showUI
- UIOption
Jestli se má vizuálně sledovat průběh operace. Výchozí je UIOption.OnlyErrorDialogs.
Výjimky
Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; nebo se jedná o cestu k zařízení (začíná na \\.\).
destinationDirectoryName nebo sourceDirectoryName je Nothing nebo prázdný řetězec.
Zdrojový adresář neexistuje.
Zdrojová a cílová cesta jsou stejné.
Operace je cyklická.
Cesta přesahuje systémem definovanou maximální délku.
Název složky v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.
Uživatel nemá potřebná oprávnění k zobrazení cesty.
Cílový soubor existuje, ale nelze k němu získat přístup.
ShowUI je nastavená na UIOption.AllDialogs hodnotu a uživatel zruší operaci, nebo nelze zkopírovat jeden nebo více souborů v adresáři.
Příklady
Následující příklad zkopíruje adresář TestDirectory1 do TestDirectory2a přepíše existující soubory.
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
Nahraďte C:\TestDirectory1 a C:\TestDirectory2 cestou a názvem adresáře, který chcete zkopírovat, a umístěním, do kterého ho chcete zkopírovat.
Poznámky
Tato metoda zkopíruje obsah adresáře i samotný adresář. Pokud cílový adresář neexistuje, vytvoří se. Pokud v cílovém umístění existuje adresář se stejným názvem, obsah těchto dvou adresářů se sloučí. Během operace můžete zadat nový název adresáře.
Při kopírování souborů v adresáři může dojít k výjimkám způsobeným konkrétním souborem. Při vyvolání takových výjimek jsou konsolidovány do jediné výjimky, jejíž Data vlastnost obsahuje položky ve formě IDictionary , ve kterém je cesta k souboru nebo adresáři klíčem a konkrétní zpráva o výjimce je obsažena v odpovídající hodnotě. Slouží For…Each k vytvoření výčtu položek.
Následující tabulka uvádí příklady úloh zahrnujících metodu My.Computer.FileSystem.CopyDirectory .
| Záměr | Seznamte se s |
|---|---|
| Kopírování adresáře | Postupy: Zkopírování adresáře do jiného adresáře |
Viz také
- UICancelOption
- Objekty (Visual Basic)
- Postupy: Získání kolekce souborů z adresáře v jazyce Visual Basic
- Postupy: Analýza cest k souborům v jazyce Visual Basic
Platí pro
CopyDirectory(String, String, Boolean)
Zkopíruje adresář do jiného adresáře.
public:
void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, bool overwrite);public void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, bool overwrite);member this.CopyDirectory : string * string * bool -> unitPublic Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, overwrite As Boolean)Parametry
- sourceDirectoryName
- String
Adresář, který se má zkopírovat.
- destinationDirectoryName
- String
Umístění, do kterého se má adresář zkopírovat.
- overwrite
- Boolean
True přepsat existující soubory; jinak False. Výchozí je False.
Výjimky
Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; nebo se jedná o cestu k zařízení (začíná na \\.\).
destinationDirectoryName nebo sourceDirectoryName je Nothing nebo prázdný řetězec.
Zdrojový adresář neexistuje.
Zdrojová a cílová cesta jsou stejné.
Operace je cyklická.
Cesta přesahuje systémem definovanou maximální délku.
Název složky v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.
Uživatel nemá potřebná oprávnění k zobrazení cesty.
Cílový soubor existuje, ale nelze k němu získat přístup.
Příklady
Následující příklad zkopíruje adresář TestDirectory1 do TestDirectory2a přepíše existující soubory.
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
Nahraďte C:\TestDirectory1 a C:\TestDirectory2 cestou a názvem adresáře, který chcete zkopírovat, a umístěním, do kterého ho chcete zkopírovat.
Poznámky
Tato metoda zkopíruje obsah adresáře i samotný adresář. Pokud cílový adresář neexistuje, vytvoří se. Pokud v cílovém umístění existuje adresář se stejným názvem, obsah těchto dvou adresářů se sloučí. Během operace můžete zadat nový název adresáře.
Při kopírování souborů v rámci adresáře může dojít k výjimkám způsobeným určitým souborem, například soubor existující během sloučení, když overwrite je nastaven na Falsehodnotu . Při vyvolání takových výjimek jsou konsolidovány do jediné výjimky, jejíž Data vlastnost obsahuje položky ve formě IDictionary , ve kterém je cesta k souboru nebo adresáři klíčem a konkrétní zpráva o výjimce je obsažena v odpovídající hodnotě. Slouží For…Each k vytvoření výčtu položek.
Následující tabulka uvádí příklady úloh zahrnujících metodu My.Computer.FileSystem.CopyDirectory .
| Záměr | Seznamte se s |
|---|---|
| Kopírování adresáře | Postupy: Zkopírování adresáře do jiného adresáře |
Viz také
- UICancelOption
- Objekty (Visual Basic)
- Postupy: Získání kolekce souborů z adresáře v jazyce Visual Basic
- Postupy: Analýza cest k souborům v jazyce Visual Basic
Platí pro
CopyDirectory(String, String, UIOption, UICancelOption)
Zkopíruje adresář do jiného adresáře.
public:
void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);member this.CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption, onUserCancel As UICancelOption)Parametry
- sourceDirectoryName
- String
Adresář, který se má zkopírovat.
- destinationDirectoryName
- String
Umístění, do kterého se má adresář 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
Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; nebo se jedná o cestu k zařízení (začíná na \\.\).
destinationDirectoryName nebo sourceDirectoryName je Nothing nebo prázdný řetězec.
Zdrojový adresář neexistuje.
Zdrojová a cílová cesta jsou stejné.
Operace je cyklická.
Cesta překračuje maximální délku definovanou systémem.
Název složky v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.
Uživatel nemá potřebná oprávnění k zobrazení cesty.
Cílový soubor existuje, ale nelze k ho získat přístup.
ShowUI je nastavená na UIOption.AllDialogs a uživatel zruší operaci nebo nelze zkopírovat jeden nebo více souborů v adresáři.
Příklady
Následující příklad zkopíruje adresář TestDirectory1 do TestDirectory2a přepíše existující soubory.
My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)
Nahraďte C:\TestDirectory1 a C:\TestDirectory2 cestou a názvem adresáře, který chcete zkopírovat, a umístěním, do kterého ho chcete zkopírovat.
Poznámky
Tato metoda zkopíruje obsah adresáře i samotného adresáře. Pokud cílový adresář neexistuje, vytvoří se. Pokud v cílovém umístění existuje adresář se stejným názvem, obsah těchto dvou adresářů se sloučí. Během operace můžete zadat nový název adresáře.
Při kopírování souborů v rámci adresáře může dojít k výjimkám způsobeným konkrétním souborem. Při vyvolání takových výjimek se konsolidují do jediné výjimky, jejíž Data vlastnost obsahuje položky ve formě IDictionary souboru nebo adresáře, ve kterém je cesta k souboru nebo adresáři klíčem a konkrétní zpráva o výjimce je obsažena v odpovídající hodnotě. Slouží For…Each k vytvoření výčtu položek.
Následující tabulka uvádí příklady úloh zahrnujících metodu My.Computer.FileSystem.CopyDirectory .
| Záměr | Seznamte se s |
|---|---|
| Kopírování adresáře | Postupy: Zkopírování adresáře do jiného adresáře |
Viz také
- UICancelOption
- Objekty (Visual Basic)
- Postupy: Získání kolekce souborů z adresáře v jazyce Visual Basic
- Postupy: Analýza cest k souborům v jazyce Visual Basic
Platí pro
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro