FileSystem.ChDir(String) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 .