FileSystem.ChDir(String) Method

Definition

Changes the current directory or folder. The My feature gives you better productivity and performance in file I/O operations than the ChDir function. For more information, see CurrentDirectory .

public:
 static void ChDir(System::String ^ Path);
public static void ChDir (string Path);
static member ChDir : string -> unit
Public Sub ChDir (Path As String)

Parameters

Path
String

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

Path is empty.

Invalid drive is specified, or drive is unavailable.

Examples

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

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

You can make relative directory changes is by typing two periods, as follows:

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

Important

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

Applies to

See also