Sdílet prostřednictvím


FileSystem.CopyDirectory Metoda

Definice

Zkopíruje obsah adresáře do jiného adresáře.

Přetížení

CopyDirectory(String, String)

Zkopíruje obsah adresáře do jiného adresáře.

CopyDirectory(String, String, UIOption)

Zkopíruje obsah adresáře do jiného adresáře.

CopyDirectory(String, String, Boolean)

Zkopíruje obsah adresáře do jiného adresáře.

CopyDirectory(String, String, UIOption, UICancelOption)

Zkopíruje obsah adresáře do jiného adresáře.

CopyDirectory(String, String)

Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb

Zkopíruje obsah adresáře do jiného adresáře.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName);
public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName);
static member CopyDirectory : string * string -> unit
Public Shared 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á obsah adresáře 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 obsah adresáře TestDirectory1 do TestDirectory2.

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2")

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 zdrojového adresáře do cílové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 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říklad úlohy zahrnující 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 v jazyce Visual Basic

Viz také

Platí pro

CopyDirectory(String, String, UIOption)

Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb

Zkopíruje obsah adresáře do jiného adresáře.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI);
public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI);
static member CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit
Public Shared 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á obsah adresáře 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 obsah adresáře TestDirectory1 do TestDirectory2, který zobrazuje dialogové okno průběhu a všechny chybové dialogy.

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", UIOption.AllDialogs)

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 zdrojového adresáře do cílové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 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říklad úlohy zahrnující 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 v jazyce Visual Basic

Viz také

Platí pro

CopyDirectory(String, String, Boolean)

Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb

Zkopíruje obsah adresáře do jiného adresáře.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, bool overwrite);
public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, bool overwrite);
static member CopyDirectory : string * string * bool -> unit
Public Shared 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á obsah adresáře 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 obsah adresáře 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 zdrojového adresáře do cílové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 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říklad úlohy zahrnující 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 v jazyce Visual Basic

Viz také

Platí pro

CopyDirectory(String, String, UIOption, UICancelOption)

Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb

Zkopíruje obsah adresáře do jiného adresáře.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
static member CopyDirectory : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Shared 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á obsah adresáře zkopírovat.

showUI
UIOption

Jestli 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ř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 obsah adresáře TestDirectory1 do TestDirectory2, který zobrazuje dialogové okno průběhu a jakékoli dialogové okno chyby, a pokud uživatel během operace klikne na Zrušit , nic neudělá.

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", UIOption.AllDialogs, UICancelOption.DoNothing)

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 zdrojového adresáře do cílové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 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říklad úlohy zahrnující 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 v jazyce Visual Basic

Viz také

Platí pro