Bagikan melalui


FileSystemProxy.MoveFile Metode

Definisi

Memindahkan file ke lokasi baru.

Overload

MoveFile(String, String)

Memindahkan file ke lokasi baru.

MoveFile(String, String, UIOption)

Memindahkan file ke lokasi baru.

MoveFile(String, String, Boolean)

Memindahkan file ke lokasi baru.

MoveFile(String, String, UIOption, UICancelOption)

Memindahkan file ke lokasi baru.

MoveFile(String, String)

Memindahkan file ke lokasi baru.

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);
public void MoveFile (string sourceFileName, string destinationFileName);
member this.MoveFile : string * string -> unit
Public Sub MoveFile (sourceFileName As String, destinationFileName As String)

Parameter

sourceFileName
String

Jalur file yang akan dipindahkan.

destinationFileName
String

Jalur direktori tempat file harus dipindahkan.

Pengecualian

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 \\.\); diakhir dengan garis miring berikutnya.

destinationFileName adalah Nothing atau string kosong.

File sumber tidak valid atau tidak ada.

File sedang digunakan oleh proses lain, atau terjadi kesalahan I/O.

Jalur melebihi panjang maksimum yang ditentukan sistem.

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

Pengguna tidak memiliki izin yang diperlukan untuk melihat jalur.

Contoh

Contoh ini memindahkan file Test.txt dari TestDir1 ke TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

Contoh ini memindahkan file Test.txt dari TestDir1 ke TestDir2 dan mengganti namanya Test2.txt.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Keterangan

Jika struktur target tidak ada, struktur tersebut dibuat.

Metode ini MoveFile mempertahankan ACE (entri Access Control) hanya ketika memindahkan file dalam volume yang sama. Ini termasuk ACE yang diwariskan, yang menjadi ACE langsung ketika dipindahkan (ACE langsung lebih diutamakan daripada ACE yang diwariskan). Jika file dipindahkan di antara volume, ACE tidak akan disalin.

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

Untuk Lihat
Memindahkan file Cara: Memindahkan File

Lihat juga

Berlaku untuk

MoveFile(String, String, UIOption)

Memindahkan file ke lokasi baru.

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);
public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);
member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit
Public Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

Parameter

sourceFileName
String

Jalur file yang akan dipindahkan.

destinationFileName
String

Jalur direktori tempat file harus dipindahkan.

showUI
UIOption

Menentukan apakah akan melacak kemajuan operasi secara visual. Defaultnya adalah UIOption.OnlyErrorDialogs.

Pengecualian

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 \\.\); diakhir dengan garis miring berikutnya.

destinationFileName adalah Nothing atau string kosong.

File sumber tidak valid atau tidak ada.

File sedang digunakan oleh proses lain, atau terjadi kesalahan I/O.

Jalur melebihi panjang maksimum yang ditentukan sistem.

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

Pengguna tidak memiliki izin yang diperlukan untuk melihat jalur.

Contoh

Contoh ini memindahkan file Test.txt dari TestDir1 ke TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

Contoh ini memindahkan file Test.txt dari TestDir1 ke TestDir2 dan mengganti namanya Test2.txt.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Keterangan

Jika struktur target tidak ada, struktur tersebut dibuat.

Metode ini MoveFile mempertahankan ACE (entri Access Control) hanya ketika memindahkan file dalam volume yang sama. Ini termasuk ACE yang diwariskan, yang menjadi ACE langsung ketika dipindahkan (ACE langsung lebih diutamakan daripada ACE yang diwariskan). Jika file dipindahkan di antara volume, ACE tidak akan disalin.

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

Untuk Lihat
Memindahkan file Cara: Memindahkan File

Lihat juga

Berlaku untuk

MoveFile(String, String, Boolean)

Memindahkan file ke lokasi baru.

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);
public void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);
member this.MoveFile : string * string * bool -> unit
Public Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

Parameter

sourceFileName
String

Jalur file yang akan dipindahkan.

destinationFileName
String

Jalur direktori tempat file harus dipindahkan.

overwrite
Boolean

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

Pengecualian

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 \\.\); diakhir dengan garis miring berikutnya.

destinationFileName adalah Nothing atau string kosong.

File sumber tidak valid atau tidak ada.

File sedang digunakan oleh proses lain, atau terjadi kesalahan I/O.

Jalur melebihi panjang maksimum yang ditentukan sistem.

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

Pengguna tidak memiliki izin yang diperlukan untuk melihat jalur.

Contoh

Contoh ini memindahkan file Test.txt dari TestDir1 ke TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

Contoh ini memindahkan file Test.txt dari TestDir1 ke TestDir2 dan mengganti namanya Test2.txt.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Keterangan

Jika struktur target tidak ada, struktur tersebut dibuat.

Metode ini MoveFile mempertahankan ACE (entri Access Control) hanya ketika memindahkan file dalam volume yang sama. Ini termasuk ACE yang diwariskan, yang menjadi ACE langsung ketika dipindahkan (ACE langsung lebih diutamakan daripada ACE yang diwariskan). Jika file dipindahkan di antara volume, ACE tidak akan disalin.

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

Untuk Lihat
Memindahkan file Cara: Memindahkan File

Lihat juga

Berlaku untuk

MoveFile(String, String, UIOption, UICancelOption)

Memindahkan file ke lokasi baru.

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)

Parameter

sourceFileName
String

Jalur file yang akan dipindahkan.

destinationFileName
String

Jalur direktori tempat file harus dipindahkan.

showUI
UIOption

Menentukan apakah akan melacak kemajuan operasi secara visual. Defaultnya adalah UIOption.OnlyErrorDialogs.

onUserCancel
UICancelOption

Menentukan apakah pengecualian dilemparkan atau tidak saat pengguna membatalkan operasi. Defaultnya adalah UICancelOption.ThrowException.

Pengecualian

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 \\.\); diakhir dengan garis miring berikutnya.

destinationFileName adalah Nothing atau string kosong.

File sumber tidak valid atau tidak ada.

File sedang digunakan oleh proses lain, atau terjadi kesalahan I/O.

onUserCancel diatur ke ThrowException, dan pengguna telah membatalkan operasi atau terjadi kesalahan I/O yang tidak ditentukan.

Jalur melebihi panjang maksimum yang ditentukan sistem.

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

Pengguna tidak memiliki izin yang diperlukan untuk melihat jalur.

Contoh

Contoh ini memindahkan file Test.txt dari TestDir1 ke TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

Contoh ini memindahkan file Test.txt dari TestDir1 ke TestDir2 dan mengganti namanya Test2.txt.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Keterangan

Jika struktur target tidak ada, struktur tersebut dibuat.

Metode ini MoveFile mempertahankan ACE (entri Access Control) hanya saat memindahkan file dalam volume yang sama. Ini termasuk ACE yang diwariskan, yang menjadi ACE langsung ketika dipindahkan (ACE langsung lebih diutamakan daripada ACE yang diwariskan). Jika file dipindahkan di antara volume, ACE tidak akan disalin.

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

Untuk Lihat
Memindahkan file Cara: Memindahkan File

Lihat juga

Berlaku untuk