Click or drag to resize
MimeKit

MailSpoolDeleteMessages(Int32, Int32, CancellationToken) Method

Mark the specified range of messages for deletion.

Namespace: MailKit
Assembly: MailKit (in MailKit.dll) Version: 4.7.1
Syntax
C#
public abstract void DeleteMessages(
	int startIndex,
	int count,
	CancellationToken cancellationToken = default
)

Parameters

startIndex  Int32
The index of the first message to mark for deletion.
count  Int32
The number of messages to mark for deletion.
cancellationToken  CancellationToken  (Optional)
The cancellation token.

Implements

IMailSpoolDeleteMessages(Int32, Int32, CancellationToken)
Exceptions
ExceptionCondition
ArgumentOutOfRangeExceptionstartIndex and count do not specify a valid range of messages.
ObjectDisposedException The MailSpool has been disposed.
ServiceNotConnectedException The MailSpool is not connected.
ServiceNotAuthenticatedException The MailSpool is not authenticated.
OperationCanceledException The operation was canceled via the cancellation token.
IOException An I/O error occurred.
CommandException The command failed.
ProtocolException A protocol error occurred.
Remarks
Messages marked for deletion are not actually deleted until the session is cleanly disconnected (see Disconnect(Boolean, CancellationToken)).
Example
C#
public static void DownloadMessages ()
{
    using (var client = new Pop3Client ()) {
        client.Connect ("pop.gmail.com", 995, SecureSocketOptions.SslOnConnect);

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

        var messages = client.DownloadMessages (0, count);

        foreach (var message in messages) {
            // write the message to a file
            message.WriteTo (string.Format ("{0}.msg", i));
        }

        client.DeleteMessages (0, count);

        client.Disconnect (true);
    }
}
See Also