FileSystemProxy.CopyDirectory Metode

Definisi

Ruang nama:

Microsoft.VisualBasic.MyServices

Rakitan:

Microsoft.VisualBasic.Forms.dll

Menyalin direktori ke direktori lain.

Overload

CopyDirectory(String, String)	Menyalin direktori ke direktori lain.
CopyDirectory(String, String, UIOption)	Menyalin direktori ke direktori lain.
CopyDirectory(String, String, Boolean)	Menyalin direktori ke direktori lain.
CopyDirectory(String, String, UIOption, UICancelOption)	Menyalin direktori ke direktori lain.

CopyDirectory(String, String)

Menyalin direktori ke direktori lain.

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)

Parameter

sourceDirectoryName

String

Direktori yang akan disalin.

destinationDirectoryName

String

Lokasi tempat direktori harus disalin.

Pengecualian

ArgumentException

Jalur ini tidak valid karena salah satu alasan berikut: ini adalah string panjang nol; hanya berisi spasi kosong; berisi karakter yang tidak valid; atau ini adalah jalur perangkat (dimulai dengan \\.\).

ArgumentNullException

destinationDirectoryName atau sourceDirectoryName adalah Nothing atau string kosong.

DirectoryNotFoundException

Direktori sumber tidak ada.

IOException

Jalur sumber dan jalur target sama.

InvalidOperationException

Operasi ini siklik.

PathTooLongException

Jalur melebihi panjang maksimum yang ditentukan sistem.

NotSupportedException

Nama folder di jalur berisi titik dua (:) atau dalam format yang tidak valid.

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk melihat jalur.

UnauthorizedAccessException

File tujuan ada tetapi tidak dapat diakses.

Contoh

Contoh berikut menyalin direktori TestDirectory1 ke dalam TestDirectory2, menimpa file yang ada.

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

Ganti C:\TestDirectory1 dan C:\TestDirectory2 dengan jalur dan nama direktori yang ingin Anda salin dan lokasi yang ingin Anda salin.

Keterangan

Metode ini menyalin konten direktori maupun direktori itu sendiri. Jika direktori target tidak ada, direktori tersebut akan dibuat. Jika direktori dengan nama yang sama ada di lokasi target, konten kedua direktori akan digabungkan. Anda dapat menentukan nama baru untuk direktori selama operasi.

Saat menyalin file dalam direktori, pengecualian dapat dilemparkan yang disebabkan oleh file tertentu. Ketika pengecualian tersebut dilemparkan, pengecualian tersebut dikonsolidasikan ke dalam satu pengecualian yang propertinya Data menyimpan entri dalam bentuk IDictionary di mana file atau jalur direktori adalah kunci dan pesan pengecualian tertentu terkandung dalam nilai yang sesuai. Gunakan For…Each untuk menghitung entri.

Tabel berikut ini mencantumkan contoh tugas yang melibatkan My.Computer.FileSystem.CopyDirectory metode .

Untuk	Lihat
Menyalin direktori	Cara: Menyalin Direktori ke Direktori Lain

Lihat juga

• UICancelOption
• Objek (Visual Basic)
• Cara: Mendapatkan Koleksi File pada Direktori di Visual Basic
• Cara: Mengurai Jalur File di Visual Basic

CopyDirectory(String, String, UIOption)

Menyalin direktori ke direktori lain.

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)

Parameter

sourceDirectoryName

String

Direktori yang akan disalin.

destinationDirectoryName

String

Lokasi tempat direktori harus disalin.

showUI

UIOption

Apakah akan melacak kemajuan operasi secara visual. Defaultnya adalah UIOption.OnlyErrorDialogs.

Pengecualian

ArgumentException

Jalur ini tidak valid karena salah satu alasan berikut: ini adalah string panjang nol; hanya berisi spasi kosong; berisi karakter yang tidak valid; atau ini adalah jalur perangkat (dimulai dengan \\.\).

ArgumentNullException

destinationDirectoryName atau sourceDirectoryName adalah Nothing atau string kosong.

DirectoryNotFoundException

Direktori sumber tidak ada.

IOException

Jalur sumber dan jalur target sama.

InvalidOperationException

Operasi ini siklik.

PathTooLongException

Jalur melebihi panjang maksimum yang ditentukan sistem.

NotSupportedException

Nama folder di jalur berisi titik dua (:) atau dalam format yang tidak valid.

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk melihat jalur.

UnauthorizedAccessException

File tujuan ada tetapi tidak dapat diakses.

OperationCanceledException

ShowUI diatur ke UIOption.AllDialogs dan pengguna membatalkan operasi, atau satu atau beberapa file dalam direktori tidak dapat disalin.

Contoh

Contoh berikut menyalin direktori TestDirectory1 ke dalam TestDirectory2, menimpa file yang ada.

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

Ganti C:\TestDirectory1 dan C:\TestDirectory2 dengan jalur dan nama direktori yang ingin Anda salin dan lokasi yang ingin Anda salin.

Keterangan

Metode ini menyalin konten direktori maupun direktori itu sendiri. Jika direktori target tidak ada, direktori tersebut akan dibuat. Jika direktori dengan nama yang sama ada di lokasi target, konten kedua direktori akan digabungkan. Anda dapat menentukan nama baru untuk direktori selama operasi.

Saat menyalin file dalam direktori, pengecualian dapat dilemparkan yang disebabkan oleh file tertentu. Ketika pengecualian tersebut dilemparkan, pengecualian tersebut dikonsolidasikan ke dalam satu pengecualian yang propertinya Data menyimpan entri dalam bentuk IDictionary di mana file atau jalur direktori adalah kunci dan pesan pengecualian tertentu terkandung dalam nilai yang sesuai. Gunakan For…Each untuk menghitung entri.

Tabel berikut ini mencantumkan contoh tugas yang melibatkan My.Computer.FileSystem.CopyDirectory metode .

Untuk	Lihat
Menyalin direktori	Cara: Menyalin Direktori ke Direktori Lain

Lihat juga

• UICancelOption
• Objek (Visual Basic)
• Cara: Mendapatkan Koleksi File pada Direktori di Visual Basic
• Cara: Mengurai Jalur File di Visual Basic

CopyDirectory(String, String, Boolean)

Menyalin direktori ke direktori lain.

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)

Parameter

sourceDirectoryName

String

Direktori yang akan disalin.

destinationDirectoryName

String

Lokasi tempat direktori harus disalin.

overwrite

Boolean

True untuk menimpa file yang ada; jika tidak False. Defaultnya adalah False.

Pengecualian

ArgumentException

Jalur ini tidak valid karena salah satu alasan berikut: ini adalah string panjang nol; hanya berisi spasi kosong; berisi karakter yang tidak valid; atau ini adalah jalur perangkat (dimulai dengan \\.\).

ArgumentNullException

destinationDirectoryName atau sourceDirectoryName adalah Nothing atau string kosong.

DirectoryNotFoundException

Direktori sumber tidak ada.

IOException

Jalur sumber dan jalur target sama.

InvalidOperationException

Operasi ini siklik.

PathTooLongException

Jalur melebihi panjang maksimum yang ditentukan sistem.

NotSupportedException

Nama folder di jalur berisi titik dua (:) atau dalam format yang tidak valid.

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk melihat jalur.

UnauthorizedAccessException

File tujuan ada tetapi tidak dapat diakses.

Contoh

Contoh berikut menyalin direktori TestDirectory1 ke dalam TestDirectory2, menimpa file yang ada.

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

Ganti C:\TestDirectory1 dan C:\TestDirectory2 dengan jalur dan nama direktori yang ingin Anda salin dan lokasi yang ingin Anda salin.

Keterangan

Metode ini menyalin konten direktori maupun direktori itu sendiri. Jika direktori target tidak ada, direktori tersebut akan dibuat. Jika direktori dengan nama yang sama ada di lokasi target, konten kedua direktori akan digabungkan. Anda dapat menentukan nama baru untuk direktori selama operasi.

Saat menyalin file dalam direktori, pengecualian dapat dilemparkan yang disebabkan oleh file tertentu, seperti file yang ada selama penggabungan saat overwrite diatur ke False. Ketika pengecualian tersebut dilemparkan, pengecualian tersebut dikonsolidasikan ke dalam satu pengecualian yang propertinya Data menyimpan entri dalam bentuk IDictionary di mana file atau jalur direktori adalah kunci dan pesan pengecualian tertentu terkandung dalam nilai yang sesuai. Gunakan For…Each untuk menghitung entri.

Tabel berikut ini mencantumkan contoh tugas yang melibatkan My.Computer.FileSystem.CopyDirectory metode .

Untuk	Lihat
Menyalin direktori	Cara: Menyalin Direktori ke Direktori Lain

Lihat juga

• UICancelOption
• Objek (Visual Basic)
• Cara: Mendapatkan Koleksi File pada Direktori di Visual Basic
• Cara: Mengurai Jalur File di Visual Basic

CopyDirectory(String, String, UIOption, UICancelOption)

Menyalin direktori ke direktori lain.

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)

Parameter

sourceDirectoryName

String

Direktori yang akan disalin.

destinationDirectoryName

String

Lokasi tempat direktori harus disalin.

showUI

UIOption

Apakah akan melacak kemajuan operasi secara visual. Defaultnya adalah UIOption.OnlyErrorDialogs.

onUserCancel

UICancelOption

Menentukan apa yang harus dilakukan jika pengguna mengklik Batal selama operasi. Defaultnya adalah ThrowException.

Pengecualian

ArgumentException

Jalur ini tidak valid karena salah satu alasan berikut: ini adalah string panjang nol; hanya berisi spasi kosong; berisi karakter yang tidak valid; atau ini adalah jalur perangkat (dimulai dengan \\.\).

ArgumentNullException

destinationDirectoryName atau sourceDirectoryName adalah Nothing atau string kosong.

DirectoryNotFoundException

Direktori sumber tidak ada.

IOException

Jalur sumber dan jalur target sama.

InvalidOperationException

Operasi ini bersifat siklik.

PathTooLongException

Jalur melebihi panjang maksimum yang ditentukan sistem.

NotSupportedException

Nama folder di jalur berisi titik dua (:) atau dalam format yang tidak valid.

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk melihat jalur.

UnauthorizedAccessException

File tujuan ada tetapi tidak dapat diakses.

OperationCanceledException

ShowUI diatur ke UIOption.AllDialogs dan pengguna membatalkan operasi, atau satu atau beberapa file dalam direktori tidak dapat disalin.

Contoh

Contoh berikut menyalin direktori TestDirectory1 ke dalam TestDirectory2, menimpa file yang ada.

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

Ganti C:\TestDirectory1 dan C:\TestDirectory2 dengan jalur dan nama direktori yang ingin Anda salin dan lokasi tempat Anda ingin menyalinnya.

Keterangan

Metode ini menyalin konten direktori maupun direktori itu sendiri. Jika direktori target tidak ada, direktori tersebut dibuat. Jika direktori dengan nama yang sama ada di lokasi target, konten kedua direktori akan digabungkan. Anda dapat menentukan nama baru untuk direktori selama operasi.

Saat menyalin file dalam direktori, pengecualian dapat dilemparkan yang disebabkan oleh file tertentu. Ketika pengecualian tersebut dilemparkan, pengecualian tersebut dikonsolidasikan ke dalam satu pengecualian yang propertinya Data menyimpan entri dalam bentuk IDictionary di mana file atau jalur direktori adalah kunci dan pesan pengecualian tertentu terkandung dalam nilai yang sesuai. Gunakan For…Each untuk menghitung entri.

Tabel berikut ini mencantumkan contoh tugas yang melibatkan My.Computer.FileSystem.CopyDirectory metode .

Untuk	Lihat
Menyalin direktori	Cara: Menyalin Direktori ke Direktori Lain

Lihat juga

• UICancelOption
• Objek (Visual Basic)
• Cara: Mendapatkan Koleksi File pada Direktori di Visual Basic
• Cara: Mengurai Jalur File di Visual Basic