SmtpClient.Host Property
.NET Framework (current version)
Gets or sets the name or IP address of the host used for SMTP transactions.
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() ); } }
.NET Framework
Available since 2.0
Available since 2.0
Show: