RawAcl.InsertAce(Int32, GenericAce) Method

Reference

Definition

Namespace:: System.Security.AccessControl

Assembly:: System.Security.AccessControl.dll

Assembly:: mscorlib.dll

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.

Inserts the specified Access Control Entry (ACE) at the specified index.

public:
 void InsertAce(int index, System::Security::AccessControl::GenericAce ^ ace);

public void InsertAce (int index, System.Security.AccessControl.GenericAce ace);

member this.InsertAce : int * System.Security.AccessControl.GenericAce -> unit

Public Sub InsertAce (index As Integer, ace As GenericAce)

Parameters

index: Int32

The position at which to add the new ACE. Specify the value of the Count property to insert an ACE at the end of the RawAcl object.

ace: GenericAce

The ACE to insert.

Exceptions

ArgumentOutOfRangeException

offset is negative or too high to allow the entire GenericAcl to be copied into array.

Remarks

The inserted ACE is not cloned before insertion, so any modifications to the ACE after it has been inserted are reflected in the Access Control List (ACL).

Applies to