Show/Hide TOC

MailServiceConnect(String, Int32, Boolean, CancellationToken) Method

Establish a connection to the specified mail server.

Definition

Namespace: MailKit
Assembly: MailKit (in MailKit.dll) Version: 5.0.0

C#

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: if the client should make an SSL-wrapped connection to the server; otherwise, .
cancellationToken CancellationToken (Optional): The cancellation token.

Implements

IMailServiceConnect(String, Int32, Boolean, CancellationToken)

Remarks

Establishes a connection to the specified mail server.

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 , 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.

Exceptions

ArgumentNullException	The host is .
ArgumentOutOfRangeException	port 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.