Nasıl yapılır: Visual Basic'te Dosyayı Yeniden Adlandırma

Visual Basic'te bir dosyayı yeniden adlandırmanın iki yolu vardır. Bir dosyayı yeniden adlandırmak için Visual Basic çalışma zamanı nesnesini My.Computer.FileSystem veya .NET tarafından sağlanan System.IO.File nesneyi kullanabilirsiniz.

.NET ile yeniden adlandırma

System.IO.File Nesnesi, bir dosyayı yeniden adlandırmak için bir yöntem içermez, bunun yerine yöntemini kullanarak Move dosyayı aynı konuma ancak farklı bir dosya adına "taşıyın". Bu yöntem, dosyayı farklı bir ada ve konuma taşımak, yani hem taşıma hem de yeniden adlandırma işlemlerini birlikte gerçekleştirmek için de kullanılabilir.

Aşağıdaki örnek, My Documents klasöründe bulunan dosyayı TextFile.txt adından NewName.txt olarak yeniden adlandırır.

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)

Visual Basic çalışma zamanı kullanarak yeniden adlandırma

Dosyanın tam yolunu ve yeni dosya adını sağlayarak bir dosyayı yeniden adlandırmak için RenameFile nesnesinin My.Computer.FileSystem yöntemini kullanın. Bu yöntem, bir dosyayı farklı bir dizine taşımak için kullanılamaz. Bir dosyanın nasıl taşınacağınızı öğrenmek için bkz . Nasıl yapılır: Visual Basic'te Dosya Taşıma.

Aşağıdaki örnek, My Documents klasöründe bulunan dosyayı TextFile.txt adından NewName.txt olarak yeniden adlandırır.

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, My.Computer.FileSystem.RenameFile kullanan bir IntelliSense kod parçacığı sağlar. Kod parçacığı , Dosya sistemi - Sürücüleri, Klasörleri ve Dosyaları İşleme'de bulunur. Daha fazla bilgi için bkz. Kod Parçacıkları.

Sağlam Programlama

Aşağıdaki koşullar özel duruma neden olabilir:

• Yol aşağıdaki nedenlerden biri için geçerli değildir: sıfır uzunluklu bir dizedir, yalnızca boşluk içerir, geçersiz karakterler içerir veya bir cihaz yoludur (\\.\) (ArgumentException ile başlar).
• newName yol bilgilerini (ArgumentException) içerir.
• Yol geçerli değil çünkü Nothing (ArgumentNullException).
• newName ya da Nothing veya boş bir dizedir (ArgumentNullException).
• Kaynak dosya geçerli değil veya yok (FileNotFoundException).
• (newName) içinde IOException belirtilen ada sahip bir dosya veya dizin var.
• Yol, sistem tarafından tanımlanan uzunluk üst sınırını (PathTooLongException) aşıyor.
• Yoldaki bir dosya veya dizin adı, iki nokta üst üste (:) içeriyor ya da geçersiz bir biçimde (NotSupportedException) olabilir.
• Kullanıcı, yolu ( ) görüntülemek için gerekli izinlere sahipSecurityException değil.
• Kullanıcının gerekli izni (UnauthorizedAccessException) yok.

Ayrıca bakınız

• RenameFile
• Move
• Nasıl yapılır: Dosyayı Taşıma
• Dosya ve Dizin Oluşturma, Silme ve Taşıma
• Nasıl yapılır: Aynı Dizinde Bir Dosyanın Kopyasını Oluşturma
• Nasıl yapılır: Farklı Bir Dizinde Dosyanın Kopyasını Oluşturma