SmtpClientVerify Method

Verify the existence of a mailbox address.

Namespace: MailKit.Net.Smtp
Assembly: MailKit (in MailKit.dll) Version: 4.12.1

Syntax

public MailboxAddress Verify(
	string address,
	CancellationToken cancellationToken = default
)

Parameters

address String: The mailbox address.
cancellationToken CancellationToken (Optional): The cancellation token.

Return Value

MailboxAddress
The expanded mailbox address.

Implements

ISmtpClientVerify(String, CancellationToken)

Exceptions

Exception	Condition
ArgumentNullException	address is .
ArgumentException	address is an empty string.
ObjectDisposedException	The SmtpClient has been disposed.
ServiceNotConnectedException	The SmtpClient is not connected.
ServiceNotAuthenticatedException	Authentication is required before verifying the existence of an address.
OperationCanceledException	The operation has been canceled.
IOException	An I/O error occurred.
SmtpCommandException	The SMTP command failed.
SmtpProtocolException	An SMTP protocol exception occurred.

Remarks

Verifies the existence a mailbox address with the SMTP server, returning the expanded mailbox address if it exists.

Example

Copy

public static void VerifyAddress ()
{
    using (var client = new SmtpClient ()) {
        client.Connect ("smtp.mail-server.com", 465, SecureSocketOptions.SslOnConnect);
        client.Authenticate ("username", "password");

        try {
            var verified = client.Verify ("smith");
            Console.WriteLine ($"'smith' was resolved the the following mailbox: {verified}");
        } catch (SmtpCommandException ex) {
            Console.WriteLine ($"'smith' is not a valid address: {ex.Message}");
        }

        client.Disconnect (true);
    }
}

Reference

SmtpClient Class

MailKit.Net.Smtp Namespace