Visual Basic Language Reference  

ChDir Function

Changes the current directory or folder.

Public Sub ChDir(ByVal Path As String)

Parameter

Path
Required. A String expression that identifies which directory or folder becomes the new default directory or folder. Path may include the drive. If no drive is specified, ChDir changes the default directory or folder on the current drive.

Exceptions/Errors

Exception type Error number Condition
ArgumentException 52 Path is empty.
FileNotFoundException 76 Invalid drive is specified, or drive is unavailable.

Remarks

The ChDir function changes the default directory, but not the default drive. For example, if the default drive is C, the following statement changes the default directory on drive D, but C remains the default drive:

ChDir "D:\TMP"

Making relative directory changes is accomplished using "..", as follows:

ChDir ".." ' Moves up one directory.

Example

This example uses the ChDir function to change the current directory or folder.

' Change current directory or folder to "MYDIR".
ChDir("MYDIR")

' Assume "C:" is the current drive. The following statement changes
' the default directory on drive "D:". "C:" remains the current drive.
ChDir("D:\WINDOWS\SYSTEM")

See Also

ChDrive Function | CurDir Function | Dir Function | MkDir Function | RmDir Function | ArgumentException | FileNotFoundException