StoreAnnotationsRequestUnchangedSince Property

Get or set a mod-sequence number that the store operation should use to decide if the annotations of a message should be updated or not.

Definition

Namespace: MailKit
Assembly: MailKit (in MailKit.dll) Version: 5.0.0
C#
public ulong? UnchangedSince { get; set; }

Property Value

NullableUInt64
The mod-sequence number.

Implements

IStoreRequestUnchangedSince

Remarks

Gets or sets a mod-sequence number that the store operation should use to decide if the annotations of a message should be updated or not.

For each message specified in the message set, the server performs the following. If the mod-sequence of every metadata item of the message affected by the store operation is equal to or less than the specified UnchangedSince value, then the requested operation is performed.

However, if the mod-sequence of any metadata item of the message is greater than the specified UnchangedSince value, then the requested operation WILL NOT be performed. In this case, the mod-sequence attribute of the message is not updated, and the message index (or unique identifier in cases where Store(IListUniqueId, IStoreAnnotationsRequest, CancellationToken) or StoreAsync(IListUniqueId, IStoreAnnotationsRequest, CancellationToken) is used) is added to the list of messages that failed the UNCHANGEDSINCE test.

  Note

The UnchangedSince mod-sequence number can only be used if the server supports the ModSequences feature.

See Also