Click or drag to resize
MimeKit

ImapFolderStoreAsync(IListUniqueId, UInt64, IListAnnotation, CancellationToken) Method

Asynchronously store the annotations for the specified messages only if their mod-sequence value is less than the specified value.

Namespace: MailKit.Net.Imap
Assembly: MailKit (in MailKit.dll) Version: 4.7.1
Syntax
C#
public override Task<IList<UniqueId>> StoreAsync(
	IList<UniqueId> uids,
	ulong modseq,
	IList<Annotation> annotations,
	CancellationToken cancellationToken = default
)

Parameters

uids  IListUniqueId
The UIDs of the messages.
modseq  UInt64
The mod-sequence value.
annotations  IListAnnotation
The annotations to store.
cancellationToken  CancellationToken  (Optional)
The cancellation token.

Return Value

TaskIListUniqueId
The unique IDs of the messages that were not updated.

Implements

IMailFolderStoreAsync(IListUniqueId, UInt64, IListAnnotation, CancellationToken)
IMailFolderStoreAsync(IListUniqueId, UInt64, IListAnnotation, CancellationToken)
Exceptions
ExceptionCondition
ArgumentNullException

uids is null.

-or-

annotations is null.

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 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.
Remarks
Asynchronously stores the annotations for the specified messages only if their mod-sequence value is less than the specified value.
See Also