FileSystemProxy.CopyDirectory Metoda

Definice

Obor názvů:

Microsoft.VisualBasic.MyServices

Sestavení:

Microsoft.VisualBasic.Forms.dll

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

Přetížení

Name	Description
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)

Zdroj:

FileSystemProxy.vb

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 -> unit

Public 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

ArgumentException

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 je to cesta zařízení (začíná na \\.\).

ArgumentNullException

destinationDirectoryName nebo je nebo sourceDirectoryName je Nothing prázdný řetězec.

DirectoryNotFoundException

Zdrojový adresář neexistuje.

IOException

Zdrojová cesta a cílová cesta jsou stejné.

InvalidOperationException

Operace je cyklická.

PathTooLongException

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

NotSupportedException

Název složky v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

SecurityException

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

UnauthorizedAccessException

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 TestDirectory2přepsání existujících souborů.

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

C:\TestDirectory1 Nahraďte C:\TestDirectory2 cestu a název 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, sloučí se obsah těchto dvou adresářů. Během operace můžete zadat nový název adresáře.

Při kopírování souborů v adresáři mohou být vyvolány výjimky, které jsou způsobeny konkrétním souborem. Pokud jsou takové výjimky vyvolány, jsou sloučeny do jediné výjimky, jejíž Data vlastnost obsahuje položky ve formě IDictionary , ve které je soubor nebo cesta k adresáři klíč a konkrétní zpráva výjimky 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 úkolů zahrnujících metodu My.Computer.FileSystem.CopyDirectory .

To	Podívejte se
Kopírování adresáře	Postupy: Kopírování adresáře do jiného adresáře

Viz také

• UICancelOption
• Objekty (Visual Basic)
• : Získání kolekce souborů v adresáři v Visual Basic
• W: Parsování cest k souborům v Visual Basic

CopyDirectory(String, String, UIOption)

Zdroj:

FileSystemProxy.vb

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 -> unit

Public 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

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

Výjimky

ArgumentException

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 je to cesta zařízení (začíná na \\.\).

ArgumentNullException

destinationDirectoryName nebo je nebo sourceDirectoryName je Nothing prázdný řetězec.

DirectoryNotFoundException

Zdrojový adresář neexistuje.

IOException

Zdrojová cesta a cílová cesta jsou stejné.

InvalidOperationException

Operace je cyklická.

PathTooLongException

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

NotSupportedException

Název složky v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

SecurityException

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

UnauthorizedAccessException

Cílový soubor existuje, ale nelze k němu získat přístup.

OperationCanceledException

ShowUI je nastaven na UIOption.AllDialogs hodnotu a uživatel operaci zruší nebo nelze zkopírovat jeden nebo více souborů v adresáři.

Příklady

Následující příklad zkopíruje adresář TestDirectory1 do TestDirectory2přepsání existujících souborů.

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

C:\TestDirectory1 Nahraďte C:\TestDirectory2 cestu a název 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, sloučí se obsah těchto dvou adresářů. Během operace můžete zadat nový název adresáře.

Při kopírování souborů v adresáři mohou být vyvolány výjimky, které jsou způsobeny konkrétním souborem. Pokud jsou takové výjimky vyvolány, jsou sloučeny do jediné výjimky, jejíž Data vlastnost obsahuje položky ve formě IDictionary , ve které je soubor nebo cesta k adresáři klíč a konkrétní zpráva výjimky 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 úkolů zahrnujících metodu My.Computer.FileSystem.CopyDirectory .

To	Podívejte se
Kopírování adresáře	Postupy: Kopírování adresáře do jiného adresáře

Viz také

• UICancelOption
• Objekty (Visual Basic)
• : Získání kolekce souborů v adresáři v Visual Basic
• W: Parsování cest k souborům v Visual Basic

CopyDirectory(String, String, Boolean)

Zdroj:

FileSystemProxy.vb

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 -> unit

Public 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řepsání existujících souborů; jinak False. Výchozí hodnota je False.

Výjimky

ArgumentException

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 je to cesta zařízení (začíná na \\.\).

ArgumentNullException

destinationDirectoryName nebo je nebo sourceDirectoryName je Nothing prázdný řetězec.

DirectoryNotFoundException

Zdrojový adresář neexistuje.

IOException

Zdrojová cesta a cílová cesta jsou stejné.

InvalidOperationException

Operace je cyklická.

PathTooLongException

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

NotSupportedException

Název složky v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

SecurityException

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

UnauthorizedAccessException

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 TestDirectory2přepsání existujících souborů.

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

C:\TestDirectory1 Nahraďte C:\TestDirectory2 cestu a název 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, sloučí se obsah těchto dvou adresářů. Během operace můžete zadat nový název adresáře.

Při kopírování souborů v adresáři mohou být vyvolány výjimky, které jsou způsobeny konkrétním souborem, například soubor existující během sloučení, zatímco overwrite je nastaven na Falsehodnotu . Pokud jsou takové výjimky vyvolány, jsou sloučeny do jediné výjimky, jejíž Data vlastnost obsahuje položky ve formě IDictionary , ve které je soubor nebo cesta k adresáři klíč a konkrétní zpráva výjimky 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 úkolů zahrnujících metodu My.Computer.FileSystem.CopyDirectory .

To	Podívejte se
Kopírování adresáře	Postupy: Kopírování adresáře do jiného adresáře

Viz také

• UICancelOption
• Objekty (Visual Basic)
• : Získání kolekce souborů v adresáři v Visual Basic
• W: Parsování cest k souborům v Visual Basic

CopyDirectory(String, String, UIOption, UICancelOption)

Zdroj:

FileSystemProxy.vb

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 -> unit

Public 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 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

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 je to cesta zařízení (začíná na \\.\).

ArgumentNullException

destinationDirectoryName nebo je nebo sourceDirectoryName je Nothing prázdný řetězec.

DirectoryNotFoundException

Zdrojový adresář neexistuje.

IOException

Zdrojová cesta a cílová cesta jsou stejné.

InvalidOperationException

Operace je cyklická.

PathTooLongException

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

NotSupportedException

Název složky v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

SecurityException

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

UnauthorizedAccessException

Cílový soubor existuje, ale nelze k němu získat přístup.

OperationCanceledException

ShowUI je nastaven na UIOption.AllDialogs hodnotu a uživatel operaci zruší nebo nelze zkopírovat jeden nebo více souborů v adresáři.

Příklady

Následující příklad zkopíruje adresář TestDirectory1 do TestDirectory2přepsání existujících souborů.

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

C:\TestDirectory1 Nahraďte C:\TestDirectory2 cestu a název 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, sloučí se obsah těchto dvou adresářů. Během operace můžete zadat nový název adresáře.

Při kopírování souborů v adresáři mohou být vyvolány výjimky, které jsou způsobeny konkrétním souborem. Pokud jsou takové výjimky vyvolány, jsou sloučeny do jediné výjimky, jejíž Data vlastnost obsahuje položky ve formě IDictionary , ve které je soubor nebo cesta k adresáři klíč a konkrétní zpráva výjimky 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 úkolů zahrnujících metodu My.Computer.FileSystem.CopyDirectory .

To	Podívejte se
Kopírování adresáře	Postupy: Kopírování adresáře do jiného adresáře

Viz také

• UICancelOption
• Objekty (Visual Basic)
• : Získání kolekce souborů v adresáři v Visual Basic
• W: Parsování cest k souborům v Visual Basic