FileSystem.ChDir Method

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 .

Namespace:  Microsoft.VisualBasic
Assembly:  Microsoft.VisualBasic (in Microsoft.VisualBasic.dll)

public static void ChDir(
	string Path
)

Parameters

Path
Type: System.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.

ExceptionCondition
ArgumentException

Path is empty.

FileNotFoundException

Invalid drive is specified, or drive is unavailable.

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.
Security noteSecurity Note

The ChDir function requires unmanaged code permission, which may affect its execution in partial-trust situations. For more information, see SecurityPermission 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")

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft