DiscretionaryAcl Class

.NET Framework (current version)

Represents a Discretionary Access Control List (DACL).

Namespace: System.Security.AccessControl
Assembly: mscorlib (in mscorlib.dll)

Inheritance Hierarchy

System::Object
System.Security.AccessControl::GenericAcl
System.Security.AccessControl::CommonAcl
System.Security.AccessControl::DiscretionaryAcl

Syntax

C++

public ref class DiscretionaryAcl sealed : CommonAcl

Constructors

	Name	Description
	DiscretionaryAcl(Boolean, Boolean, Byte, Int32)	Initializes a new instance of the DiscretionaryAcl class with the specified values.
	DiscretionaryAcl(Boolean, Boolean, Int32)	Initializes a new instance of the DiscretionaryAcl class with the specified values.
	DiscretionaryAcl(Boolean, Boolean, RawAcl^)	Initializes a new instance of the DiscretionaryAcl class with the specified values from the specified RawAcl object.

Properties

	Name	Description
	BinaryLength	Gets the length, in bytes, of the binary representation of the current CommonAcl object. This length should be used before marshaling the access control list (ACL) into a binary array by using the GetBinaryForm method.(Inherited from CommonAcl.)
	Count	Gets the number of access control entries (ACEs) in the current CommonAcl object.(Inherited from CommonAcl.)
	IsCanonical	Gets a Boolean value that specifies whether the access control entries (ACEs) in the current CommonAcl object are in canonical order.(Inherited from CommonAcl.)
	IsContainer	Sets whether the CommonAcl object is a container. (Inherited from CommonAcl.)
	IsDS	Sets whether the current CommonAcl object is a directory object access control list (ACL).(Inherited from CommonAcl.)
	IsSynchronized	This property is always set to false. It is implemented only because it is required for the implementation of the ICollection interface.(Inherited from GenericAcl.)
	Item[Int32]	Gets or sets the CommonAce at the specified index.(Inherited from CommonAcl.)
	Revision	Gets the revision level of the CommonAcl.(Inherited from CommonAcl.)
	SyncRoot	This property always returns null. It is implemented only because it is required for the implementation of the ICollection interface.(Inherited from GenericAcl.)

Methods

	Name	Description
	AddAccess(AccessControlType, SecurityIdentifier^, Int32, InheritanceFlags, PropagationFlags)	Adds an Access Control Entry (ACE) with the specified settings to the current DiscretionaryAcl object.
	AddAccess(AccessControlType, SecurityIdentifier^, Int32, InheritanceFlags, PropagationFlags, ObjectAceFlags, Guid, Guid)	Adds an Access Control Entry (ACE) with the specified settings to the current DiscretionaryAcl object. Use this method for directory object Access Control Lists (ACLs) when specifying the object type or the inherited object type for the new ACE.
	AddAccess(AccessControlType, SecurityIdentifier^, ObjectAccessRule^)	Adds an Access Control Entry (ACE) with the specified settings to the current DiscretionaryAcl object.
	CopyTo(array<GenericAce^>^, Int32)	Copies each GenericAce of the current GenericAcl into the specified array.(Inherited from GenericAcl.)
	Equals(Object^)	Determines whether the specified object is equal to the current object.(Inherited from Object.)
	GetBinaryForm(array<Byte>^, Int32)	Marshals the contents of the CommonAcl object into the specified byte array beginning at the specified offset.(Inherited from CommonAcl.)
	GetEnumerator()	Retrieves an object that you can use to iterate through the access control entries (ACEs) in an access control list (ACL).(Inherited from GenericAcl.)
	GetHashCode()	Serves as the default hash function. (Inherited from Object.)
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	Purge(SecurityIdentifier^)	Removes all access control entries (ACEs) contained by this CommonAcl object that are associated with the specified SecurityIdentifier object.(Inherited from CommonAcl.)
	RemoveAccess(AccessControlType, SecurityIdentifier^, Int32, InheritanceFlags, PropagationFlags)	Removes the specified access control rule from the current DiscretionaryAcl object.
	RemoveAccess(AccessControlType, SecurityIdentifier^, Int32, InheritanceFlags, PropagationFlags, ObjectAceFlags, Guid, Guid)	Removes the specified access control rule from the current DiscretionaryAcl object. Use this method for directory object Access Control Lists (ACLs) when specifying the object type or the inherited object type.
	RemoveAccess(AccessControlType, SecurityIdentifier^, ObjectAccessRule^)	Removes the specified access control rule from the current DiscretionaryAcl object.
	RemoveAccessSpecific(AccessControlType, SecurityIdentifier^, Int32, InheritanceFlags, PropagationFlags)	Removes the specified Access Control Entry (ACE) from the current DiscretionaryAcl object.
	RemoveAccessSpecific(AccessControlType, SecurityIdentifier^, Int32, InheritanceFlags, PropagationFlags, ObjectAceFlags, Guid, Guid)	Removes the specified Access Control Entry (ACE) from the current DiscretionaryAcl object. Use this method for directory object Access Control Lists (ACLs) when specifying the object type or the inherited object type for the ACE to be removed.
	RemoveAccessSpecific(AccessControlType, SecurityIdentifier^, ObjectAccessRule^)	Removes the specified Access Control Entry (ACE) from the current DiscretionaryAcl object.
	RemoveInheritedAces()	Removes all inherited access control entries (ACEs) from this CommonAcl object.(Inherited from CommonAcl.)
	SetAccess(AccessControlType, SecurityIdentifier^, Int32, InheritanceFlags, PropagationFlags)	Sets the specified access control for the specified SecurityIdentifier object.
	SetAccess(AccessControlType, SecurityIdentifier^, Int32, InheritanceFlags, PropagationFlags, ObjectAceFlags, Guid, Guid)	Sets the specified access control for the specified SecurityIdentifier object.
	SetAccess(AccessControlType, SecurityIdentifier^, ObjectAccessRule^)	Sets the specified access control for the specified SecurityIdentifier object.
	ToString()	Returns a string that represents the current object.(Inherited from Object.)

Explicit Interface Implementations

	Name	Description
	ICollection::CopyTo(Array^, Int32)	Copies each GenericAce of the current GenericAcl into the specified array.(Inherited from GenericAcl.)
	IEnumerable::GetEnumerator()	Returns a new instance of the AceEnumerator class cast as an instance of the IEnumerator interface.(Inherited from GenericAcl.)

Extension Methods

	Name	Description
	AsParallel()	Overloaded. Enables parallelization of a query.(Defined by ParallelEnumerable.)
	AsQueryable()	Overloaded. Converts an IEnumerable to an IQueryable.(Defined by Queryable.)
	Cast<TResult>()	Casts the elements of an IEnumerable to the specified type.(Defined by Enumerable.)
	OfType<TResult>()	Filters the elements of an IEnumerable based on a specified type.(Defined by Enumerable.)

Version Information

.NET Framework
Available since 2.0

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.