Bagikan melalui

FileSystem.MoveFile Metode

  • Referensi

Definisi

Ruang nama:
Microsoft.VisualBasic.FileIO
Rakitan:
Microsoft.VisualBasic.Core.dll
Rakitan:
Microsoft.VisualBasic.dll

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)

Sumber:
FileSystem.vb
Sumber:
FileSystem.vb
Sumber:
FileSystem.vb

Memindahkan file ke lokasi baru.

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);
public static void MoveFile (string sourceFileName, string destinationFileName);
static member MoveFile : string * string -> unit
Public Shared 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

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

ArgumentNullException

destinationFileName adalah Nothing atau string kosong.

FileNotFoundException

File sumber tidak valid atau tidak ada.

IOException

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

PathTooLongException

Jalur melebihi panjang maksimum yang ditentukan sistem.

NotSupportedException

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

SecurityException

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 di Visual Basic

Berlaku untuk

MoveFile(String, String, UIOption)

Sumber:
FileSystem.vb
Sumber:
FileSystem.vb
Sumber:
FileSystem.vb

Memindahkan file ke lokasi baru.

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);
public static void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);
static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit
Public Shared 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

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

ArgumentNullException

destinationFileName adalah Nothing atau string kosong.

FileNotFoundException

File sumber tidak valid atau tidak ada.

IOException

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

PathTooLongException

Jalur melebihi panjang maksimum yang ditentukan sistem.

NotSupportedException

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

SecurityException

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 di Visual Basic

Lihat juga

Berlaku untuk

MoveFile(String, String, Boolean)

Sumber:
FileSystem.vb
Sumber:
FileSystem.vb
Sumber:
FileSystem.vb

Memindahkan file ke lokasi baru.

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);
public static void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);
static member MoveFile : string * string * bool -> unit
Public Shared 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

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

ArgumentNullException

destinationFileName adalah Nothing atau string kosong.

FileNotFoundException

File sumber tidak valid atau tidak ada.

IOException

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

PathTooLongException

Jalur melebihi panjang maksimum yang ditentukan sistem.

NotSupportedException

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

SecurityException

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 di Visual Basic

Berlaku untuk

MoveFile(String, String, UIOption, UICancelOption)

Sumber:
FileSystem.vb
Sumber:
FileSystem.vb
Sumber:
FileSystem.vb

Memindahkan file ke lokasi baru.

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public static void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Shared 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

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

ArgumentNullException

destinationFileName adalah Nothing atau string kosong.

FileNotFoundException

File sumber tidak valid atau tidak ada.

IOException

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

OperationCanceledException

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

PathTooLongException

Jalur melebihi panjang maksimum yang ditentukan sistem.

NotSupportedException

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

SecurityException

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 di Visual Basic

Lihat juga

Berlaku untuk