Edit

DirectorySecurity Constructors

  • Reference

Definition

Namespace:
System.Security.AccessControl
Assembly:
System.IO.FileSystem.AccessControl.dll
Assembly:
mscorlib.dll

Initializes a new instance of the DirectorySecurity class.

Overloads

DirectorySecurity()

Initializes a new instance of the DirectorySecurity class.
DirectorySecurity(String, AccessControlSections)

Initializes a new instance of the DirectorySecurity class from a specified directory using the specified values of the AccessControlSections enumeration.

DirectorySecurity()

Initializes a new instance of the DirectorySecurity class.

public:
 DirectorySecurity();
public DirectorySecurity ();
Public Sub New ()

Exceptions

PlatformNotSupportedException

The current operating system is not Microsoft Windows 2000 or later.

Remarks

Use this constructor when you want to create an empty DirectorySecurity object that is not based on an existing directory. You can then populate the object with access control information and apply it to a directory.

Applies to

DirectorySecurity(String, AccessControlSections)

Initializes a new instance of the DirectorySecurity class from a specified directory using the specified values of the AccessControlSections enumeration.

public:
 DirectorySecurity(System::String ^ name, System::Security::AccessControl::AccessControlSections includeSections);
public DirectorySecurity (string name, System.Security.AccessControl.AccessControlSections includeSections);
new System.Security.AccessControl.DirectorySecurity : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.DirectorySecurity
Public Sub New (name As String, includeSections As AccessControlSections)

Parameters

name
String

The location of a directory to create a DirectorySecurity object from.

includeSections
AccessControlSections

One of the AccessControlSections values that specifies the type of access control list (ACL) information to retrieve.

Exceptions

ArgumentException

The name parameter is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

The name parameter is null.

DirectoryNotFoundException

The specified path is invalid, (for example, it is on an unmapped drive).

FileNotFoundException

The file specified in the name parameter was not found.

IOException

An I/O error occurred while opening the directory.

NotSupportedException

The name parameter is in an invalid format.

PlatformNotSupportedException

The current operating system is not Microsoft Windows 2000 or later.

PathTooLongException

The specified path, file name, or both exceed the system-defined maximum length.

PrivilegeNotHeldException

The current system account does not have administrative privileges.

SystemException

The directory could not be found.

UnauthorizedAccessException

The name parameter specified a directory that is read-only.

-or-

This operation is not supported on the current platform.

-or-

The caller does not have the required permission.

Remarks

This constructor retrieves the access control information for the specified directory and then creates a DirectorySecurity object that encapsulates that information. You can then inspect, add, or delete the access control information for the specified directory.

Applies to