Procedure: De naam van een bestand wijzigen in Visual Basic
In Visual Basic zijn er twee manieren om de naam van een bestand te wijzigen. U kunt het Runtime-object My.Computer.FileSystem van Visual Basic of het opgegeven System.IO.File .NET-object gebruiken om de naam van een bestand te wijzigen.
Naam wijzigen met .NET
Het System.IO.File object bevat geen methode om de naam van een bestand te wijzigen. Gebruik in plaats daarvan de Move methode om het bestand naar dezelfde locatie te verplaatsen, maar met een andere bestandsnaam. Deze methode kan ook worden gebruikt om het bestand met een andere naam naar een andere locatie te verplaatsen, een verplaatsing uit te voeren en de naam ervan samen te wijzigen.
In het volgende voorbeeld wordt de naam van het bestand in de My Documents map gewijzigd van TextFile.txt in 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)
Naam wijzigen met de Visual Basic-runtime
Gebruik de RenameFile methode van het object om de My.Computer.FileSystem naam van een bestand te wijzigen door het volledige pad naar het bestand en de nieuwe bestandsnaam op te geven. Deze methode kan niet worden gebruikt om een bestand naar een andere map te verplaatsen. Zie Een bestand verplaatsen in Visual Basic voor meer informatie over het verplaatsen van een bestand.
In het volgende voorbeeld wordt de naam van het bestand in de My Documents map gewijzigd van TextFile.txt in 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 biedt een IntelliSense-codefragment dat gebruikmaakt van My.Computer.FileSystem.RenameFile. Het codefragment bevindt zich in het bestandssysteem: verwerkingsstations, mappen en bestanden. Zie Codefragmenten voor meer informatie.
Robuuste programmering
De volgende voorwaarden kunnen een uitzondering veroorzaken:
- Het pad is om een van de volgende redenen niet geldig: het is een tekenreeks met lengte nul, het bevat alleen witruimte, bevat ongeldige tekens of het is een apparaatpad (begint met \\.\) (ArgumentException).
newNamebevat padinformatie (ArgumentException).- Het pad is ongeldig omdat het (ArgumentNullException) is
Nothing. newNameisNothingof een lege tekenreeks (ArgumentNullException).- Het bronbestand is niet geldig of bestaat niet (FileNotFoundException).
- Er is een bestaand bestand of een bestaande map met de naam die is opgegeven in
newName(IOException). - Het pad overschrijdt de door het systeem gedefinieerde maximumlengte (PathTooLongException).
- Een bestands- of mapnaam in het pad bevat een dubbele punt (:) of heeft een ongeldige indeling (NotSupportedException).
- De gebruiker beschikt niet over de benodigde machtigingen om het pad (SecurityException) weer te geven.
- De gebruiker heeft niet de vereiste machtiging (UnauthorizedAccessException).
