SendCompleted Event
Collapse the table of content
Expand the table of content

SmtpClient.SendCompleted Event


Occurs when an asynchronous e-mail send operation completes.

Namespace:   System.Net.Mail
Assembly:  System (in System.dll)

public event SendCompletedEventHandler SendCompleted

The SendCompleted event is raised each time an e-mail message is sent asynchronously when the send operation completes. To send an e-mail message asynchronously, use the SendAsync methods.

SendCompletedEventHandler is the delegate for SendCompleted. The AsyncCompletedEventArgs class provides the event handler with event data.

The following code example demonstrates sending an e-mail message asynchronously.

using System;
using System.Net;
using System.Net.Mail;
using System.Net.Mime;
using System.Threading;
using System.ComponentModel;
namespace Examples.SmptExamples.Async
    public class SimpleAsynchronousExample
        static bool mailSent = false;
        private static void SendCompletedCallback(object sender, AsyncCompletedEventArgs e)
            // Get the unique identifier for this asynchronous operation.
             String token = (string) e.UserState;

            if (e.Cancelled)
                 Console.WriteLine("[{0}] Send canceled.", token);
            if (e.Error != null)
                 Console.WriteLine("[{0}] {1}", token, e.Error.ToString());
            } else
                Console.WriteLine("Message sent.");
            mailSent = true;
        public static void Main(string[] args)
            // Command line argument must the the SMTP host.
            SmtpClient client = new SmtpClient(args[0]);
            // Specify the e-mail sender.
            // Create a mailing address that includes a UTF8 character
            // in the display name.
            MailAddress from = new MailAddress("", 
               "Jane " + (char)0xD8+ " Clayton", 
            // Set destinations for the e-mail message.
            MailAddress to = new MailAddress("");
            // Specify the message content.
            MailMessage message = new MailMessage(from, to);
            message.Body = "This is a test e-mail message sent by an application. ";
            // Include some non-ASCII characters in body and subject.
            string someArrows = new string(new char[] {'\u2190', '\u2191', '\u2192', '\u2193'});
            message.Body += Environment.NewLine + someArrows;
            message.BodyEncoding =  System.Text.Encoding.UTF8;
            message.Subject = "test message 1" + someArrows;
            message.SubjectEncoding = System.Text.Encoding.UTF8;
            // Set the method that is called back when the send operation ends.
            client.SendCompleted += new 
            // The userState can be any object that allows your callback 
            // method to identify this send operation.
            // For this example, the userToken is a string constant.
            string userState = "test message1";
            client.SendAsync(message, userState);
            Console.WriteLine("Sending message... press c to cancel mail. Press any other key to exit.");
            string answer = Console.ReadLine();
            // If the user canceled the send, and mail hasn't been sent yet,
            // then cancel the pending operation.
            if (answer.StartsWith("c") && mailSent == false)
            // Clean up.

.NET Framework
Available since 2.0
Return to top
© 2015 Microsoft