SmtpClient.Host Property
Gets or sets the name or IP address of the host used for SMTP transactions.
Namespace: System.Net.Mail
Assembly: System (in System.dll)
| Exception | Condition |
|---|---|
| ArgumentNullException | The value specified for a set operation is null. |
| ArgumentException | The value specified for a set operation is equal to String.Empty (""). |
| InvalidOperationException | You cannot change the value of this property when an email is being sent. |
The value of the Host property can also be set using constructors or the application or machine configuration file. For more information, see <mailSettings> Element (Network Settings).
If information is specified using this property, this information overrides the configuration file settings.
The following code example demonstrates sending an e-mail message by using the host and port specified in an application configuration file.
public static void CreateTestMessage4(string server) { MailAddress from = new MailAddress("ben@contoso.com"); MailAddress to = new MailAddress("Jane@contoso.com"); MailMessage message = new MailMessage(from, to); message.Subject = "Using the SmtpClient class."; message.Body = @"Using this feature, you can send an e-mail message from an application very easily."; SmtpClient client = new SmtpClient(server); Console.WriteLine("Sending an e-mail message to {0} by using SMTP host {1} port {2}.", to.ToString(), client.Host, client.Port); try { client.Send(message); } catch (Exception ex) { Console.WriteLine("Exception caught in CreateTestMessage4(): {0}", ex.ToString() ); } }
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
