ImapFolderStoreAsync(IListUniqueId, IStoreAnnotationsRequest, CancellationToken) Method

Asynchronously store the annotations for a set of messages.

Definition

Namespace: MailKit.Net.Imap
Assembly: MailKit (in MailKit.dll) Version: 5.0.0
C#
public override Task<IList<UniqueId>> StoreAsync(
	IList<UniqueId> uids,
	IStoreAnnotationsRequest request,
	CancellationToken cancellationToken = default
)

Parameters

uids  IListUniqueId
The message UIDs.
request  IStoreAnnotationsRequest
The annotations to store.
cancellationToken  CancellationToken  (Optional)
The cancellation token.

Return Value

TaskIListUniqueId
The UIDs of the messages that were not updated.

Implements

IMailFolderStoreAsync(IListUniqueId, IStoreAnnotationsRequest, CancellationToken)
IMailFolderStoreAsync(IListUniqueId, IStoreAnnotationsRequest, CancellationToken)

Remarks

Asynchronously stores the annotations for a set of messages.

Exceptions

ArgumentNullException

uids is .

-or-

request is .

ArgumentException One or more of the uids is invalid.
ObjectDisposedException The ImapClient has been disposed.
ServiceNotConnectedException The ImapClient is not connected.
ServiceNotAuthenticatedException The ImapClient is not authenticated.
FolderNotOpenException The ImapFolder is not currently open in read-write mode.
InvalidOperationException Cannot store annotations without any properties defined.
NotSupportedException

The ImapFolder does not support annotations.

-or-

The request specified an UnchangedSince value but the ImapFolder does not support mod-sequences.

OperationCanceledException The operation was canceled via the cancellation token.
IOException An I/O error occurred.
ImapProtocolException The server's response contained unexpected tokens.
ImapCommandException The server replied with a NO or BAD response.

See Also