IMailFolderStoreAsync(IListInt32, IStoreLabelsRequest, CancellationToken) Method

Asynchronously store GMail-style labels for a set of messages.

Definition

Namespace: MailKit
Assembly: MailKit (in MailKit.dll) Version: 5.0.0
C#
Task<IList<int>> StoreAsync(
	IList<int> indexes,
	IStoreLabelsRequest request,
	CancellationToken cancellationToken = default
)

Parameters

indexes  IListInt32
The message indexes.
request  IStoreLabelsRequest
The labels to store.
cancellationToken  CancellationToken  (Optional)
The cancellation token.

Return Value

TaskIListInt32
The indexes of the messages that were not updated.

Remarks

Asynchronously updates the GMail-style labels for a set of message.

Exceptions

ArgumentNullException

indexes is .

-or-

request is .
ArgumentException One or more of the indexes is invalid.
ObjectDisposedException The IMailStore has been disposed.
ServiceNotConnectedException The IMailStore is not connected.
ServiceNotAuthenticatedException The IMailStore is not authenticated.
FolderNotOpenException The folder is not currently open in read-write mode.
NotSupportedException

The folder does not support storing labels.

-or-

The request specified an UnchangedSince value but the folder does not support mod-sequences.
OperationCanceledException The operation was canceled via the cancellation token.
IOException An I/O error occurred.
ProtocolException The server's response contained unexpected tokens.
CommandException The command failed.

See Also