Export (0) Print
Expand All
3 out of 4 rated this helpful - Rate this topic

ChDir Function 

Changes the current directory or folder.

The My feature provides you with greater productivity and performance in file I/O operations than the ChDir function. For more information, see My.Computer.FileSystem.CurrentDirectory Property


Public Sub ChDir(ByVal Path As String)

Parameters

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.

Exception type Error number Condition

ArgumentException

52

Path is empty.

FileNotFoundException

76

Invalid drive is specified, or drive is unavailable.

See the "Error number" column if you are upgrading Visual Basic 6.0 applications that use unstructured error handling. (You can compare the error number against the Number Property (Err Object).) However, when possible, you should consider replacing such error control with Structured Exception Handling Overview for Visual Basic.

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 by typing two periods, as follows:

ChDir("..") ' Moves up one directory.

Security noteSecurity Note

The ChDir function requires unmanaged code permission, which may affect its execution in partial-trust situations. For more information, see SecurityPermission Class and Code Access Permissions.

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")

This function is not supported.

Namespace: Microsoft.VisualBasic

Module: FileSystem

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

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.