SmtpClient.ServicePoint SmtpClient.ServicePoint SmtpClient.ServicePoint SmtpClient.ServicePoint Property

Definition

Namespace:: System.Net.Mail System.Net.Mail System.Net.Mail System.Net.Mail

Assemblies:: System.dll, netstandard.dll, System.Net.Mail.dll

Gets the network connection used to transmit the email message.

public:
 property System::Net::ServicePoint ^ ServicePoint { System::Net::ServicePoint ^ get(); };

public System.Net.ServicePoint ServicePoint { get; }

member this.ServicePoint : System.Net.ServicePoint

Public ReadOnly Property ServicePoint As ServicePoint

Property Value

ServicePoint ServicePoint ServicePoint ServicePoint

A ServicePoint that connects to the Host property used for SMTP.

Exceptions

InvalidOperationException InvalidOperationException InvalidOperationException InvalidOperationException

Host is null or the empty string ("").

-or-

Port is zero.

Examples

The following code example demonstrates accessing the ServicePoint property.

static void CreateTestMessage1( String^ server, int port )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   String^ subject = L"Using the new SMTP client.";
   String^ body = L"Using this new feature, you can send an email message from an application very easily.";
   MailMessage^ message = gcnew MailMessage( from,to,subject,body );
   SmtpClient^ client = gcnew SmtpClient( server,port );
   
   // Credentials are necessary if the server requires the client 
   // to authenticate before it will send email on the client's behalf.
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   
   //Display the properties on the service point.
   ServicePoint^ p = client->ServicePoint;
   Console::WriteLine( L"Connection lease timeout: {0}", p->ConnectionLeaseTimeout );
   client->Send( message );
client->~SmtpClient();
}

public static void CreateTestMessage1(string server, int port)
{
	string to = "jane@contoso.com";
	string from = "ben@contoso.com";
	string subject = "Using the new SMTP client.";
	string body = @"Using this new feature, you can send an email message from an application very easily.";
	MailMessage message = new MailMessage(from, to, subject, body);
	SmtpClient client = new SmtpClient(server, port);
	// Credentials are necessary if the server requires the client 
	// to authenticate before it will send email on the client's behalf.
	client.Credentials = CredentialCache.DefaultNetworkCredentials;
          client.Send(message);
}

Remarks

The settings for the ServicePoint property are created using defaults specified in the application or machine configuration files and the ServicePointManager class.