DirectoryInfo Constructor (String)
Initializes a new instance of the DirectoryInfo class on the specified path.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- path
-
Type:
System.String
A string specifying the path on which to create the DirectoryInfo.
| Exception | Condition |
|---|---|
| ArgumentNullException | path is null. |
| SecurityException | The caller does not have the required permission. |
| ArgumentException | path contains invalid characters such as ", <, >, or |. |
| PathTooLongException | The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters. The specified path, file name, or both are too long. |
This constructor does not check if a directory exists. This constructor is a placeholder for a string that is used to access the disk in subsequent operations.
The path parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.
Caution |
|---|
When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown. |
For a list of common I/O tasks, see Common I-O Tasks.
The following example uses this constructor to create the specified directory and subdirectory, and demonstrates that a directory that contains subdirectories cannot be deleted.
using System; using System.IO; class Test { public static void Main() { // Specify the directories you want to manipulate. DirectoryInfo di1 = new DirectoryInfo(@"c:\MyDir"); DirectoryInfo di2 = new DirectoryInfo(@"c:\MyDir\temp"); try { // Create the directories. di1.Create(); di2.Create(); // This operation will not be allowed because there are subdirectories. Console.WriteLine("I am about to attempt to delete {0}.", di1.Name); di1.Delete(); Console.WriteLine("The Delete operation was successful, which was unexpected."); } catch (Exception) { Console.WriteLine("The Delete operation failed as expected."); } finally {} } }
for reading from files and directories. Associated enumeration: FileIOPermissionAccess.Read
Available since 10
.NET Framework
Available since 1.1
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
