FileSystem.CopyDirectory Metódus

Definíció

Névtér:

Microsoft.VisualBasic.FileIO

Szerelvény:

Microsoft.VisualBasic.Core.dll

Átmásolja egy könyvtár tartalmát egy másik könyvtárba.

Túlterhelések

Name	Description
CopyDirectory(String, String)	Átmásolja egy könyvtár tartalmát egy másik könyvtárba.
CopyDirectory(String, String, UIOption)	Átmásolja egy könyvtár tartalmát egy másik könyvtárba.
CopyDirectory(String, String, Boolean)	Átmásolja egy könyvtár tartalmát egy másik könyvtárba.
CopyDirectory(String, String, UIOption, UICancelOption)	Átmásolja egy könyvtár tartalmát egy másik könyvtárba.

CopyDirectory(String, String)

Forrás:

FileSystem.vb

Átmásolja egy könyvtár tartalmát egy másik könyvtárba.

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)

Paraméterek

sourceDirectoryName

String

A másolandó könyvtár.

destinationDirectoryName

String

A könyvtár tartalmának másolási helye.

Kivételek

ArgumentException

Az elérési út az alábbi okok egyike miatt nem érvényes: nulla hosszúságú sztring; csak üres helyet tartalmaz; érvénytelen karaktereket tartalmaz; vagy egy eszköz elérési útja (\\.\-val kezdődik).

ArgumentNullException

destinationDirectoryName sourceDirectoryName vagy Nothing üres sztring.

DirectoryNotFoundException

A forráskönyvtár nem létezik.

IOException

A forrás elérési útja és a cél elérési útja megegyezik.

InvalidOperationException

A művelet ciklikus.

PathTooLongException

Az elérési út meghaladja a rendszer által megadott maximális hosszt.

NotSupportedException

Az elérési út egyik mappaneve kettőspontot tartalmaz (:) vagy érvénytelen formátumú.

SecurityException

A felhasználó nem rendelkezik az elérési út megtekintéséhez szükséges engedélyekkel.

UnauthorizedAccessException

Létezik célfájl, de nem érhető el.

Példák

Az alábbi példa bemásolja a könyvtár TestDirectory1TestDirectory2tartalmát.

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

Cserélje le C:\TestDirectory1 a C:\TestDirectory2 másolni kívánt könyvtár elérési útját és nevét, valamint azt a helyet, ahová másolni szeretné.

Megjegyzések

Ez a metódus a forráskönyvtár tartalmát a célkönyvtárba másolja. Ha a célkönyvtár nem létezik, létrejön. Ha a célhelyen ugyanazzal a névvel rendelkező könyvtár található, a rendszer egyesíti a két könyvtár tartalmát. A művelet során megadhat egy új nevet a címtárnak.

Fájlok könyvtáron belüli másolása esetén előfordulhat, hogy egy adott fájl kivételeket okoz. Amikor ilyen kivételeket adnak ki, a rendszer egyetlen kivételbe konszolidálja őket, amelynek Data tulajdonsága olyan bejegyzéseket tartalmaz, IDictionary amelyekben a fájl vagy könyvtár elérési útja a kulcs, és az adott kivételüzenetet a megfelelő érték tartalmazza. A bejegyzések számbavételére használható For…Each .

Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.FileSystem.CopyDirectory .

Címzett	Nézze
Másolj egy könyvtárat	Bemutató: Címtár másolása másik könyvtárba Visual Basic

Lásd még

• UICancelOption

CopyDirectory(String, String, UIOption)

Forrás:

FileSystem.vb

Átmásolja egy könyvtár tartalmát egy másik könyvtárba.

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)

Paraméterek

sourceDirectoryName

String

A másolandó könyvtár.

destinationDirectoryName

String

A könyvtár tartalmának másolási helye.

showUI

UIOption

A művelet előrehaladásának vizuális nyomon követése. Az alapértelmezett érték UIOption.OnlyErrorDialogs.

Kivételek

ArgumentException

Az elérési út az alábbi okok egyike miatt nem érvényes: nulla hosszúságú sztring; csak üres helyet tartalmaz; érvénytelen karaktereket tartalmaz; vagy egy eszköz elérési útja (\\.\-val kezdődik).

ArgumentNullException

destinationDirectoryName sourceDirectoryName vagy Nothing üres sztring.

DirectoryNotFoundException

A forráskönyvtár nem létezik.

IOException

A forrás elérési útja és a cél elérési útja megegyezik.

InvalidOperationException

A művelet ciklikus.

PathTooLongException

Az elérési út meghaladja a rendszer által megadott maximális hosszt.

NotSupportedException

Az elérési út egyik mappaneve kettőspontot tartalmaz (:) vagy érvénytelen formátumú.

SecurityException

A felhasználó nem rendelkezik az elérési út megtekintéséhez szükséges engedélyekkel.

UnauthorizedAccessException

Létezik célfájl, de nem érhető el.

OperationCanceledException

ShowUI be van állítva UIOption.AllDialogs , és a felhasználó megszakítja a műveletet, vagy a címtárban lévő egy vagy több fájl nem másolható.

Példák

Az alábbi példa bemásolja a könyvtár TestDirectory1TestDirectory2tartalmát a folyamatjelző párbeszédpanelre és a hibaablakba.

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

Cserélje le C:\TestDirectory1 a C:\TestDirectory2 másolni kívánt könyvtár elérési útját és nevét, valamint azt a helyet, ahová másolni szeretné.

Megjegyzések

Ez a metódus a forráskönyvtár tartalmát a célkönyvtárba másolja. Ha a célkönyvtár nem létezik, létrejön. Ha a célhelyen ugyanazzal a névvel rendelkező könyvtár található, a rendszer egyesíti a két könyvtár tartalmát. A művelet során megadhat egy új nevet a címtárnak.

Fájlok könyvtáron belüli másolása esetén előfordulhat, hogy egy adott fájl kivételeket okoz. Amikor ilyen kivételeket adnak ki, a rendszer egyetlen kivételbe konszolidálja őket, amelynek Data tulajdonsága olyan bejegyzéseket tartalmaz, IDictionary amelyekben a fájl vagy könyvtár elérési útja a kulcs, és az adott kivételüzenetet a megfelelő érték tartalmazza. A bejegyzések számbavételére használható For…Each .

Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.FileSystem.CopyDirectory .

Címzett	Nézze
Másolj egy könyvtárat	Bemutató: Címtár másolása másik könyvtárba Visual Basic

Lásd még

• UICancelOption

CopyDirectory(String, String, Boolean)

Forrás:

FileSystem.vb

Átmásolja egy könyvtár tartalmát egy másik könyvtárba.

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)

Paraméterek

sourceDirectoryName

String

A másolandó könyvtár.

destinationDirectoryName

String

A könyvtár tartalmának másolási helye.

overwrite

Boolean

True meglévő fájlok felülírása; egyéb esetben False. Az alapértelmezett érték False.

Kivételek

ArgumentException

Az elérési út az alábbi okok egyike miatt nem érvényes: nulla hosszúságú sztring; csak üres helyet tartalmaz; érvénytelen karaktereket tartalmaz; vagy egy eszköz elérési útja (\\.\-val kezdődik).

ArgumentNullException

destinationDirectoryName sourceDirectoryName vagy Nothing üres sztring.

DirectoryNotFoundException

A forráskönyvtár nem létezik.

IOException

A forrás elérési útja és a cél elérési útja megegyezik.

InvalidOperationException

A művelet ciklikus.

PathTooLongException

Az elérési út meghaladja a rendszer által megadott maximális hosszt.

NotSupportedException

Az elérési út egyik mappaneve kettőspontot tartalmaz (:) vagy érvénytelen formátumú.

SecurityException

A felhasználó nem rendelkezik az elérési út megtekintéséhez szükséges engedélyekkel.

UnauthorizedAccessException

Létezik célfájl, de nem érhető el.

Példák

Az alábbi példa a könyvtár TestDirectory1TestDirectory2tartalmát átmásolja a meglévő fájlok felülírására.

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

Cserélje le C:\TestDirectory1 a C:\TestDirectory2 másolni kívánt könyvtár elérési útját és nevét, valamint azt a helyet, ahová másolni szeretné.

Megjegyzések

Ez a metódus a forráskönyvtár tartalmát a célkönyvtárba másolja. Ha a célkönyvtár nem létezik, létrejön. Ha a célhelyen ugyanazzal a névvel rendelkező könyvtár található, a rendszer egyesíti a két könyvtár tartalmát. A művelet során megadhat egy új nevet a címtárnak.

Fájlok könyvtáron belüli másolásakor előfordulhat, hogy egy adott fájl kivételeket okoz, például egy egyesítés során meglévő fájlt, miközben overwrite a beállítás értéke Falsea következő. Amikor ilyen kivételeket adnak ki, a rendszer egyetlen kivételbe konszolidálja őket, amelynek Data tulajdonsága olyan bejegyzéseket tartalmaz, IDictionary amelyekben a fájl vagy könyvtár elérési útja a kulcs, és az adott kivételüzenetet a megfelelő érték tartalmazza. A bejegyzések számbavételére használható For…Each .

Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.FileSystem.CopyDirectory .

Címzett	Nézze
Másolj egy könyvtárat	Bemutató: Címtár másolása másik könyvtárba Visual Basic

Lásd még

• UICancelOption

CopyDirectory(String, String, UIOption, UICancelOption)

Forrás:

FileSystem.vb

Átmásolja egy könyvtár tartalmát egy másik könyvtárba.

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)

Paraméterek

sourceDirectoryName

String

A másolandó könyvtár.

destinationDirectoryName

String

A könyvtár tartalmának másolási helye.

showUI

UIOption

A művelet előrehaladásának vizuális nyomon követése. Az alapértelmezett érték UIOption.OnlyErrorDialogs.

onUserCancel

UICancelOption

Megadja, hogy mit kell tenni, ha a felhasználó a Művelet során a Mégse gombra kattint. Az alapértelmezett érték ThrowException.

Kivételek

ArgumentException

Az elérési út az alábbi okok egyike miatt nem érvényes: nulla hosszúságú sztring; csak üres helyet tartalmaz; érvénytelen karaktereket tartalmaz; vagy egy eszköz elérési útja (\\.\-val kezdődik).

ArgumentNullException

destinationDirectoryName sourceDirectoryName vagy Nothing üres sztring.

DirectoryNotFoundException

A forráskönyvtár nem létezik.

IOException

A forrás elérési útja és a cél elérési útja megegyezik.

InvalidOperationException

A művelet ciklikus.

PathTooLongException

Az elérési út meghaladja a rendszer által megadott maximális hosszt.

NotSupportedException

Az elérési út egyik mappaneve kettőspontot tartalmaz (:) vagy érvénytelen formátumú.

SecurityException

A felhasználó nem rendelkezik az elérési út megtekintéséhez szükséges engedélyekkel.

UnauthorizedAccessException

Létezik célfájl, de nem érhető el.

OperationCanceledException

ShowUI be van állítva UIOption.AllDialogs , és a felhasználó megszakítja a műveletet, vagy a címtárban lévő egy vagy több fájl nem másolható.

Példák

Az alábbi példa bemásolja a könyvtár TestDirectory1 tartalmát a folyamatjelző párbeszédpanelre és a hibaablakba TestDirectory2, és nem tesz semmit, ha a felhasználó a Művelet során a Mégse gombra kattint.

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

Cserélje le C:\TestDirectory1 a C:\TestDirectory2 másolni kívánt könyvtár elérési útját és nevét, valamint azt a helyet, ahová másolni szeretné.

Megjegyzések

Ez a metódus a forráskönyvtár tartalmát a célkönyvtárba másolja. Ha a célkönyvtár nem létezik, létrejön. Ha a célhelyen ugyanazzal a névvel rendelkező könyvtár található, a rendszer egyesíti a két könyvtár tartalmát. A művelet során megadhat egy új nevet a címtárnak.

Fájlok könyvtáron belüli másolása esetén előfordulhat, hogy egy adott fájl kivételeket okoz. Amikor ilyen kivételeket adnak ki, a rendszer egyetlen kivételbe konszolidálja őket, amelynek Data tulajdonsága olyan bejegyzéseket tartalmaz, IDictionary amelyekben a fájl vagy könyvtár elérési útja a kulcs, és az adott kivételüzenetet a megfelelő érték tartalmazza. A bejegyzések számbavételére használható For…Each .

Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.FileSystem.CopyDirectory .

Címzett	Nézze
Másolj egy könyvtárat	Bemutató: Címtár másolása másik könyvtárba Visual Basic

Lásd még

• UICancelOption