The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Send Mail Sample 

Download sample

This sample shows how to send email over SMTP using classes in the System.Web.Mail namespace.

Security noteSecurity Note

This sample code is provided to illustrate a concept and should not be used in applications or Web sites, as it may not illustrate the safest coding practices. Microsoft assumes no liability for incidental or consequential damages should the sample code be used for purposes other than as intended.

To open the sample file in Solution Explorer

  1. Click Download Sample.

    The File Download message box appears.

  2. Click Open, and on the left column of the zip folder window, click Extract all files.

    The Extraction Wizard opens.

  3. Click Next. You can change the directory that the files will be extracted to, and then click Next again.

  4. Make sure that the Show extracted files check box is selected, and click Finish.

  5. Double-click the sample's .sln file.

    The sample solution is displayed in Solution Explorer. You might get a security warning that says the solution location is not trusted. Click OK to continue.

To run this sample

  1. Check the SmtpServer property setting. See "Requirements," below, for more information.

  2. Press F5.


  1. Internet Information Services (IIS) is required.

  2. SMTP Service must be installed and running. SMTP Service is an option installed with IIS.

  3. The SmtpServer property must be set to the IP address or server name where the SMTP Server is running. In most cases this is the "localhost" computer. As such, the SmtpServer property value can either be the friendly name, "localhost", or "". The latter is the default for this application. To find the SMTP server name:

    1. Open the IIS snap-in (In Control Panel, open Administrative Tools, and then open Internet Information Services).

    2. Expand the Default SMTP Virtual Server node.

    3. Click Domains. In the right pane you will see a list of Domain Names. You may set the SmtpServer property to one of these names or its corresponding IP address.

  4. The Default SMTP Virtual Server must also be running. Be aware that it is possible for the SMTP Service to be running, but the Default SMTP Server in IIS to be stopped. There is a difference between the service itself and the actual server run by the service. If your Default SMTP Virtual Server is not running, a red X icon will be visible over its node in the IIS snap-in. To start the server, right-click its node and click Start.

  5. Set the relay restrictions:

    1. In IIS, right-click Default SMTP Virtual Server and select Properties.

    2. In the Properties dialog box click the Access tab.

    3. Click Relay.

    4. In the Relay Restrictions dialog box, select the box labeled All except the list below. The bottom check box can be selected or cleared.


This application has a single form with controls similar to the Microsoft Outlook e-mail client. When the form loads, it checks to make sure the user has the SMTP Service installed and that it is running.

See Also

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

© 2014 Microsoft