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.
static void CreateTestMessage4( String^ server ) { MailAddress^ from = gcnew MailAddress( L"ben@contoso.com" ); MailAddress^ to = gcnew MailAddress( L"Jane@contoso.com" ); MailMessage^ message = gcnew MailMessage( from,to ); message->Subject = L"Using the SmtpClient class."; message->Body = L"Using this feature, you can send an e-mail message from an application very easily."; SmtpClient^ client = gcnew SmtpClient( server ); Console::WriteLine( L"Sending an e-mail message to {0} by using SMTP host {1} port {2}.", to, client->Host, client->Port ); client->Send( message ); client->~SmtpClient(); }
.NET Framework
Available since 2.0
Available since 2.0
Show: