Cara: Mengganti Nama File di Visual Basic

Di Visual Basic, ada dua cara untuk mengganti nama file. Anda dapat menggunakan objek run-time Visual Basic atau objek My.Computer.FileSystem yang disediakan System.IO.File .NET untuk mengganti nama file.

Ganti nama dengan .NET

Objek System.IO.File tidak berisi metode untuk mengganti nama file, sebagai gantinya, gunakan Move metode untuk "memindahkan" file ke lokasi yang sama tetapi dengan nama file yang berbeda. Metode ini juga dapat digunakan untuk memindahkan file ke lokasi lain dengan nama yang berbeda, melakukan pemindahan dan mengganti nama bersama- sama.

Contoh berikut mengganti nama file yang terletak di My Documents folder dari TextFile.txt menjadi NewName.txt.

Dim myDocsFolder As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments
Dim filePathSource = System.IO.Path.Combine(myDocsFolder, "TextFile.txt")
Dim filePathTarget = System.IO.Path.Combine(myDocsFolder, "NewName.txt")

System.IO.File.Move(filePathSource, filePathTarget)

Mengganti nama dengan run-time Visual Basic

RenameFile Gunakan metode My.Computer.FileSystem objek untuk mengganti nama file dengan menyediakan jalur lengkap ke file dan nama file baru. Metode ini tidak dapat digunakan untuk memindahkan file ke direktori lain. Untuk mempelajari cara memindahkan file, lihat Cara: Memindahkan File di Visual Basic.

Contoh berikut mengganti nama file yang terletak di My Documents folder dari TextFile.txt menjadi NewName.txt.

Dim myDocsFolder As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments
Dim filePath = System.IO.Path.Combine(myDocsFolder, "TextFile.txt")

My.Computer.FileSystem.RenameFile(filePath, "NewName.txt")

Visual Studio menyediakan cuplikan kode IntelliSense yang menggunakan My.Computer.FileSystem.RenameFile. Cuplikan terletak di sistem File - Memproses Drive, Folder, dan File. Untuk informasi selengkapnya, lihat Cuplikan Kode.

Pemrograman yang Kuat

Kondisi berikut dapat menyebabkan pengecualian:

• Jalur tidak valid karena salah satu alasan berikut: ini adalah string panjang nol, hanya berisi spasi kosong, berisi karakter yang tidak valid, atau jalur perangkat (dimulai dengan \\.\) (ArgumentException).
• newName berisi informasi jalur (ArgumentException).
• Jalur tidak valid karena (NothingArgumentNullException).
• newName adalah Nothing atau string kosong (ArgumentNullException).
• File sumber tidak valid atau tidak ada (FileNotFoundException).
• Ada file atau direktori yang sudah ada dengan nama yang ditentukan dalam newName (IOException).
• Jalur melebihi panjang maksimum yang ditentukan sistem (PathTooLongException).
• Nama file atau direktori di jalur berisi titik dua (:) atau dalam format yang tidak valid (NotSupportedException).
• Pengguna tidak memiliki izin yang diperlukan untuk melihat jalur (SecurityException).
• Pengguna tidak memiliki izin yang diperlukan (UnauthorizedAccessException).

Lihat juga

• RenameFile
• Move
• Cara: Memindahkan File
• Membuat, Menghapus, dan Memindahkan File dan Direktori
• Cara: Membuat Salinan File di Direktori yang Sama
• Cara: Membuat Salinan File di Direktori Lain