This article is focused on understanding the Directory class of System.IO namespace.
Introduction This article is focused on understanding the Directory class of System.IO namespace. The Directory class exposes routines for manipulating directories & subdirectories. It contains all kinds of routines like creating, moving, and enumerating through directories and subdirectories. In most of the application developments we require some file accesses or directory accesses normally we use some low-level system API like Directory-Control Routines in C (ex:- _mkdir, _chdir, _rmdir) or Platform SDK function of Kernel32.lib (ex:- CreateDirectory(),SetCurrentDirectory(),RemoveDirectory()). In .net we have System.IO.Directory class to do all directory manipulation. For better understanding I will compare code with some C & SDK programs. You will see how easy it is in C# when compared to old programming languages.
Let take a small example to get all the available drive information (this includes both physical & logical drives).
#include <stdio.h>#include <conio.h>#include <direct.h>#include <stdlib.h>#include <ctype.h>void main( void ){int drive, curdrive;static char path[_MAX_PATH];/* Save current drive. */curdrive = _getdrive();printf( "Using C routines, Available drives are: \n" );/* If we can switch to the drive, it exists. */for( drive = 1; drive <= 26; drive++ )if( !_chdrive( drive ) )printf( "%c: \n", drive + 'A' - 1 );}
#include <Windows.h>#include <stdio.h>void main( void ){char *lpBuffer=new char[1000];long retSize;retSize=GetLogicalDriveStrings(1000,lpBuffer);printf("Using SDK routines, Available drives are:\n");for(int i=0;i<=retSize;i++){if(lpBuffer[i]!='\0')printf("%c",lpBuffer[i]);elseprintf("\n");}}
Output: Using C routines, Available drives are: A:\ C:\ D:\ E:\ Z:\
Output: Using SDK routines, Available drives are: A:\ C:\ D:\ E:\ Z:\
The same program we will do in C#
GetDr.cs
using
Output:
Using C# Directory Class, Available drives are:
A:\C:\D:\E:\Z:\
So lets understand how this works System.IO.Directory class has method called GetLogicalDrives() this method returns all available drives in your system as array of strings. Before that some important thing to remember is all methods of the Directory class are static and can therefore be called without having an instance of a directory. The static methods of the Directory class do a security check on all methods. If you are going to reuse an object several times, consider using the corresponding instance method of DirectoryInfo instead, because the security check will not always be necessary.
Now that we know about Directory class so we will examine the IL code of C# sample (getDr.exe) and also System.IO library.
(IL code of sample code getDr.exe)IL_0000:call string[] ['mscorlib']'System.IO'.'Directory'::'GetLogicalDrives'()
|
V
(IL code of System.IO library)IL_000b: call int32 Microsoft.Win32.Win32Native::GetLogicalDrives()
(IL code of System.IO library).method assembly hidebysig static pinvokeimpl("kernel32.dll" lasterr winapi)int32 GetLogicalDrives() cil managed preservesig
{ }
If you see the above IL code of System.IO library it internally calls the kernel32.dll GetLogicalDrives() which is nothing but File I/O function in Kernel32.dll library which retrieves a bitmask representing the currently available disk drives. When you call Directory Class methods of System.IO library it internally pinvokes the Microsoft Win32 native functions (see the above Platform SDK code).Similarly we will see a sample code to create and change directory. For this sample code we will be using Directory.CreateDirectory(), Directory.GetCurrentDirectory() ,Directory.Delete(), Directory.Exists() and Directory.SetCurrentDirectory(). chgDr.cs
Output: D:\samples\vstudio>chgDr--> Your Current DirectoryD:\samples\vstudio--> 'TestDir' Directory created--> Changing to 'TestDir' DirectoryD:\samples\vstudio\TestDir--> Changing to 'D:\samples\vstudio' DirectoryD:\samples\vstudio--> Deleting 'TestDir' Directory--> Checking 'TestDir' Directory Exists or not'TestDir' Does not exists
Some points to remember:
Further reading
OOPs Principle and Theory