This documentation is archived and is not being maintained.

SmtpClient.SmtpClient() Constructor

Initializes a new instance of the SmtpClient class by using configuration file settings.

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

public SmtpClient ()
public SmtpClient ()
public function SmtpClient ()
Not applicable.

This constructor initializes the Host, Credentials, and Port properties for the new SmtpClient by using the settings in the application or machine configuration files. For more information, see mailSettings Element (Network Settings).

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

public static void CreateTestMessage3()
    MailAddress to = new MailAddress("");
    MailAddress from = new MailAddress("");
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the new SMTP client.";
    message.Body = @"Using this new feature, you can send an e-mail message from an application very easily.";
    // Use the application or machine configuration to get the 
    // host, port, and credentials.
    SmtpClient client = new SmtpClient();
    Console.WriteLine("Sending an e-mail message to {0} at {1} by using the SMTP host {2}.",
        to.User, to.Host, client.Host);

For an example of the <mailSettings> node in the application or machine configuration file, see mailSettings Element (Network Settings).

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0