AccessControlList Class

An Access Control List (ACL)

Definition

Namespace: MailKit
Assembly: MailKit (in MailKit.dll) Version: 5.0.0
C#
public class AccessControlList : IList<AccessControl>, 
	ICollection<AccessControl>, IEnumerable<AccessControl>, IEnumerable, 
	IReadOnlyList<AccessControl>, IReadOnlyCollection<AccessControl>
Inheritance
Object    AccessControlList
Implements
ICollectionAccessControl, IEnumerableAccessControl, IListAccessControl, IReadOnlyCollectionAccessControl, IReadOnlyListAccessControl, IEnumerable

Remarks

An Access Control List (ACL) is a list of access controls defining the permissions various identities have available.

Example

C#
                    public static void Capabilities ()
{
    using (var client = new ImapClient ()) {
        client.Connect ("imap.gmail.com", 993, SecureSocketOptions.SslOnConnect);

        var mechanisms = string.Join (", ", client.AuthenticationMechanisms);
        Console.WriteLine ("The IMAP server supports the following SASL authentication mechanisms: {0}", mechanisms);

        client.Authenticate ("username", "password");

        if (client.Capabilities.Contains (ImapCapability.Id)) {
            var clientImplementation = new ImapImplementation { Name = "MailKit", Version = "1.0" };
            var serverImplementation = client.Identify (clientImplementation);

            Console.WriteLine ("Server implementation details:");
            foreach (var property in serverImplementation.Properties)
                Console.WriteLine ("  {0} = {1}", property.Key, property.Value);
        }

        if (client.Capabilities.Contains (ImapCapability.Acl)) {
            Console.WriteLine ("The IMAP server supports Access Control Lists.");

            Console.WriteLine ("The IMAP server supports the following access rights: {0}", client.Rights);

            Console.WriteLine ("The Inbox has the following access controls:");
            var acl = client.Inbox.GetAccessControlList ();
            foreach (var ac in acl)
                Console.WriteLine ("  {0} = {1}", ac.Name, ac.Rights);

            var myRights = client.Inbox.GetMyAccessRights ();
            Console.WriteLine ("Your current rights for the Inbox folder are: {0}", myRights);
        }

        if (client.Capabilities.Contains (ImapCapability.Quota)) {
            Console.WriteLine ("The IMAP server supports quotas.");

            Console.WriteLine ("The current quota for the Inbox is:");
            var quota = client.Inbox.GetQuota ();

            if (quota.StorageLimit.HasValue)
                Console.WriteLine ("  Limited by storage space. Using {0} out of {1} kilobytes.", quota.CurrentStorageSize.Value, quota.StorageLimit.Value);

            if (quota.MessageLimit.HasValue)
                Console.WriteLine ("  Limited by the number of messages. Using {0} out of {1} messages.", quota.CurrentMessageCount.Value, quota.MessageLimit.Value);

            Console.WriteLine ("The quota root is: {0}", quota.QuotaRoot);
        }

        if (client.Capabilities.Contains (ImapCapability.Thread)) {
            if (client.ThreadingAlgorithms.Contains (ThreadingAlgorithm.OrderedSubject))
                Console.WriteLine ("The IMAP server supports threading by subject.");
            if (client.ThreadingAlgorithms.Contains (ThreadingAlgorithm.References))
                Console.WriteLine ("The IMAP server supports threading by references.");
        }

        client.Disconnect (true);
    }
}
                  

Constructors

AccessControlList Initializes a new instance of the AccessControlList class.
AccessControlList(IEnumerableAccessControl) Initializes a new instance of the AccessControlList class.

Properties

Count Get the number of access controls in the list.
IsReadOnly Get whether or not the list is read only.
Item Get or set the access control at the specified index.

Methods

Add Add the specified access control.
AddRange Add the specified access controls.
Clear Clear the list of access controls.
Contains Check if the list contains the specified access control.
CopyTo Copy all of the access controls to the specified array.
Equals Determines whether the specified object is equal to the current object.
(Inherited from Object)
Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object)
GetEnumerator Get an enumerator for the list of access controls.
GetHashCode Serves as the default hash function.
(Inherited from Object)
GetType Gets the Type of the current instance.
(Inherited from Object)
IndexOf Get the index of the specified access control.
Insert Insert the specified access control at the specified index.
MemberwiseClone Creates a shallow copy of the current Object.
(Inherited from Object)
Remove Remove the specified access control.
RemoveAt Remove the access control at the specified index.
ToString Returns a string that represents the current object.
(Inherited from Object)

See Also

Reference