Share via


My.Computer.FileSystem.RenameFile Method

Renames a file.

' Usage
My.Computer.FileSystem.RenameFile(file ,newName)
' Declaration
Public Sub RenameFile( _
   ByVal file As String, _
   ByVal newName As String _
)

Parameters

  • file
    String. File to be renamed. Required.

  • newName
    String. New name of file. Required.

Exceptions

The following conditions may cause an exception:

Remarks

This method cannot be used to move a file; use the My.Computer.FileSystem.MoveFile Method to move and rename the file.

Tasks

The following table lists an example of a task involving the My.Computer.FileSystem.RenameFile method.

To

See

Rename a file

How to: Rename a File in Visual Basic

Example

This example renames the file Test.txt to SecondTest.txt.

My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")

Change "C:\Test.txt" to the path and file name of the file that you want to rename.

Requirements

Namespace:Microsoft.VisualBasic.MyServices

Class:FileSystemProxy (provides access to FileSystem)

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Availability by Project Type

Project type

Available

Windows Application

Yes

Class Library

Yes

Console Application

Yes

Windows Control Library

Yes

Web Control Library

Yes

Windows Service

Yes

Web Site

Yes

Permissions

The following permission may be necessary:

Permission

Description

FileIOPermission

Controls the ability to access files and folders. Associated enumeration: Unrestricted.

For more information, see Code Access Security and Requesting Permissions.

See Also

Reference

My.Computer.FileSystem Object

FileSystem.RenameFile

Other Resources

Creating, Deleting, and Moving Files and Directories in Visual Basic