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 sahip farklı bir konuma taşımak ve birlikte taşıma ve yeniden adlandırma gerçekleştirmek için de kullanılabilir.
Aşağıdaki örnek, klasöründe bulunan My Documents
dosyayı olarak TextFile.txt
NewName.txt
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ı ile yeniden adlandırma
RenameFile
Dosyanın tam yolunu ve yeni dosya adını sağlayarak dosyayı yeniden adlandırmak için nesnesinin yöntemini My.Computer.FileSystem
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, klasöründe bulunan My Documents
dosyayı olarak TextFile.txt
NewName.txt
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, kullanan My.Computer.FileSystem.RenameFile
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ı.
Güçlü 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 (ArgumentNullException olduğundan
Nothing
geçerli değil. newName
veyaNothing
boş bir dize (ArgumentNullException ).- Kaynak dosya geçerli değil veya yok (FileNotFoundException).
- (IOException) içinde
newName
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 (:) veya geçersiz biçimde (NotSupportedException ) içeriyor.
- Kullanıcı, yolu ( ) görüntülemek için gerekli izinlere sahipSecurityException değil.
- Kullanıcının gerekli izni (UnauthorizedAccessException) yok.