Udostępnij za pośrednictwem

Porady: zmienianie nazwy pliku w Visual Basic

  • Artykuł

W języku Visual Basic istnieją dwa sposoby zmiany nazwy pliku. Aby zmienić nazwę pliku, możesz użyć obiektu My.Computer.FileSystem czasu wykonywania języka Visual Basic lub udostępnionego System.IO.File obiektu platformy .NET.

Zmienianie nazwy za pomocą platformy .NET

Obiekt System.IO.File nie zawiera metody zmiany nazwy pliku, zamiast tego użyj Move metody , aby "przenieść" plik do tej samej lokalizacji, ale z inną nazwą pliku. Tej metody można również użyć do przeniesienia pliku do innej lokalizacji o innej nazwie, wykonując przeniesienie i zmianę nazwy razem.

Poniższy przykład zmienia nazwę pliku znajdującego się w folderze My Documents z TextFile.txt na 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)

Zmienianie nazwy za pomocą środowiska uruchomieniowego języka Visual Basic

RenameFile Użyj metody My.Computer.FileSystem obiektu, aby zmienić nazwę pliku, podając pełną ścieżkę do pliku i nową nazwę pliku. Tej metody nie można użyć do przeniesienia pliku do innego katalogu. Aby dowiedzieć się, jak przenieść plik, zobacz How to: Move a File in Visual Basic (Jak: przenoszenie pliku w Visual Basic).

Poniższy przykład zmienia nazwę pliku znajdującego się w folderze My Documents z TextFile.txt na 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")

Program Visual Studio udostępnia fragment kodu funkcji IntelliSense, który używa elementu My.Computer.FileSystem.RenameFile. Fragment kodu znajduje się w systemie plików — dyski przetwarzania, foldery i pliki. Aby uzyskać więcej informacji, zobacz Fragmenty kodu.

Niezawodne programowanie

Następujące warunki mogą spowodować wyjątek:

  • Ścieżka nie jest prawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości, zawiera tylko białe znaki, zawiera nieprawidłowe znaki lub ścieżkę urządzenia (zaczyna się od \\.\) (ArgumentException).
  • newName zawiera informacje o ścieżce (ArgumentException).
  • Ścieżka nie jest prawidłowa, ponieważ jest Nothing (ArgumentNullException).
  • newName jest Nothing lub pusty ciąg (ArgumentNullException).
  • Plik źródłowy jest nieprawidłowy lub nie istnieje (FileNotFoundException).
  • Istnieje plik lub katalog o nazwie określonej w newName (IOException).
  • Ścieżka przekracza zdefiniowaną przez system maksymalną długość (PathTooLongException).
  • Nazwa pliku lub katalogu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie (NotSupportedException).
  • Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki (SecurityException).
  • Użytkownik nie ma wymaganych uprawnień (UnauthorizedAccessException).

Zobacz też