Export (0) Print
Expand All

AceCollection Class

Represents a collection of access control entries specifying access rights for one or more trustees.

System.Object
  System.Collections.CollectionBase
    Microsoft.ReportingServices.Interfaces.AceCollection

Namespace:  Microsoft.ReportingServices.Interfaces
Assemblies:   Microsoft.ReportingServices.SharePoint.UI.WebParts (in Microsoft.ReportingServices.SharePoint.UI.WebParts.dll)
  Microsoft.ReportingServices.Interfaces (in Microsoft.ReportingServices.Interfaces.dll)

[SerializableAttribute]
public sealed class AceCollection : CollectionBase

The AceCollection type exposes the following members.

  NameDescription
Public methodAceCollectionInitializes a new instance of the AceCollection class.
Top

  NameDescription
Public propertyCapacity (Inherited from CollectionBase.)
Public propertyCount (Inherited from CollectionBase.)
Protected propertyInnerList (Inherited from CollectionBase.)
Public propertyItemGets or sets the element at the specified index. In C#, this property is the indexer for the AceCollection class.
Protected propertyList (Inherited from CollectionBase.)
Top

  NameDescription
Public methodAddAdds an object to the end of the AceCollection.
Public methodClear (Inherited from CollectionBase.)
Public methodEquals (Inherited from Object.)
Protected methodFinalize (Inherited from Object.)
Public methodGetEnumerator (Inherited from CollectionBase.)
Public methodGetHashCode (Inherited from Object.)
Public methodGetType (Inherited from Object.)
Protected methodMemberwiseClone (Inherited from Object.)
Protected methodOnClear (Inherited from CollectionBase.)
Protected methodOnClearComplete (Inherited from CollectionBase.)
Protected methodOnInsert (Inherited from CollectionBase.)
Protected methodOnInsertComplete (Inherited from CollectionBase.)
Protected methodOnRemove (Inherited from CollectionBase.)
Protected methodOnRemoveComplete (Inherited from CollectionBase.)
Protected methodOnSet (Inherited from CollectionBase.)
Protected methodOnSetComplete (Inherited from CollectionBase.)
Protected methodOnValidate (Inherited from CollectionBase.)
Public methodRemoveAt (Inherited from CollectionBase.)
Public methodToString (Inherited from Object.)
Top

  NameDescription
Explicit interface implemetationPrivate methodIList.Add (Inherited from CollectionBase.)
Explicit interface implemetationPrivate methodIList.Contains (Inherited from CollectionBase.)
Explicit interface implemetationPrivate methodICollection.CopyTo (Inherited from CollectionBase.)
Explicit interface implemetationPrivate methodIList.IndexOf (Inherited from CollectionBase.)
Explicit interface implemetationPrivate methodIList.Insert (Inherited from CollectionBase.)
Explicit interface implemetationPrivate propertyIList.IsFixedSize (Inherited from CollectionBase.)
Explicit interface implemetationPrivate propertyIList.IsReadOnly (Inherited from CollectionBase.)
Explicit interface implemetationPrivate propertyICollection.IsSynchronized (Inherited from CollectionBase.)
Explicit interface implemetationPrivate propertyIList.Item (Inherited from CollectionBase.)
Explicit interface implemetationPrivate methodIList.Remove (Inherited from CollectionBase.)
Explicit interface implemetationPrivate propertyICollection.SyncRoot (Inherited from CollectionBase.)
Top

An AceCollection instance contains items of type AceStruct and is used to represent an access control list (ACL) for items in the report server database.

An AceCollection identifies the trustees that are allowed access to a securable item in the report server database. When a user or process tries to access a securable item, the security extension checks the access control entries in the object's access control entry collection to determine whether to grant access to it. The security extension checks the access control entries in sequence until it finds one or more that allow all the requested access rights. For more information about access checks, see CheckAccess.

An AceCollection is similar to an access control list in Microsoft Windows. It is a list that tells a report server which access rights each user has to a particular item in the report server database, such as a folder or an individual report. Each item has a security descriptor that identifies its access control list. The list has an entry for each system user with access privileges. The most common privileges include the ability to read properties, to update content, and to execute reports. Each access control list has one or more access control entries consisting of the name of a user or group and the operations that user is allowed to perform. For each of these users or groups, the access privileges are stated in a collection of enumerable operations. Generally, the system administrator or the item owner creates the access control list for an object when setting report server policies through the Report Server Web service. Management applications (like Report Manager) call the Web service SetPolicies and SetSystemPolicies methods.

An AceCollection is passed as an argument to the CreateSecurityDescriptor method of the IAuthorizationExtension interface. You implement CreateSecurityDescriptor to serialize the AceCollection and any other metadata that you require for your security descriptor. You must also process the AceCollection for an item in the report server database when you implement the CheckAccess method.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft