Click or drag to resize
MimeKit

MailServiceConnect(String, Int32, Boolean, CancellationToken) Method

Establish a connection to the specified mail server.

Namespace: MailKit
Assembly: MailKit (in MailKit.dll) Version: 4.7.1
Syntax
C#
Copy
public void Connect(
	string host,
	int port,
	bool useSsl,
	CancellationToken cancellationToken = default
)

Parameters

host  String
The host to connect to.
port  Int32
The port to connect to. If the specified port is 0, then the default port will be used.
useSsl  Boolean

Field Value

true if the client should make an SSL-wrapped connection to the server; otherwise,

Field Value

false.
cancellationToken  CancellationToken  (Optional)
The cancellation token.

Implements

IMailServiceConnect(String, Int32, Boolean, CancellationToken)
Exceptions
ExceptionCondition
ArgumentNullException The host is null.
ArgumentOutOfRangeExceptionport is out of range (

Field Value

0 to

Field Value

65535, inclusive).
ArgumentException The host is a zero-length string.
ObjectDisposedException The MailService has been disposed.
InvalidOperationException The MailService is already connected.
OperationCanceledException The operation was canceled via the cancellation token.
SocketException A socket error occurred trying to connect to the remote host.
IOException An I/O error occurred.
ProtocolException A protocol error occurred.
Remarks

Establishes a connection to the specified mail server.

Note  Note

The useSsl argument only controls whether or not the client makes an SSL-wrapped connection. In other words, even if the useSsl parameter is false, SSL/TLS may still be used if the mail server supports the STARTTLS extension.

To disable all use of SSL/TLS, use the Connect(String, Int32, SecureSocketOptions, CancellationToken) overload with a value of SecureSocketOptions.None instead.

See Also