Click or drag to resize
MimeKit

MailServiceConnectAsync(Socket, String, Int32, SecureSocketOptions, CancellationToken) Method

Asynchronously establish a connection to the specified mail server using the provided socket.

Namespace: MailKit
Assembly: MailKit (in MailKit.dll) Version: 4.7.1
Syntax
C#
public abstract Task ConnectAsync(
	Socket socket,
	string host,
	int port = 0,
	SecureSocketOptions options = SecureSocketOptions.Auto,
	CancellationToken cancellationToken = default
)

Parameters

socket  Socket
The socket to use for the connection.
host  String
The host name to connect to.
port  Int32  (Optional)
The port to connect to. If the specified port is 0, then the default port will be used.
options  SecureSocketOptions  (Optional)
The secure socket options to when connecting.
cancellationToken  CancellationToken  (Optional)
The cancellation token.

Return Value

Task
An asynchronous task context.

Implements

IMailServiceConnectAsync(Socket, String, Int32, SecureSocketOptions, CancellationToken)
Exceptions
ExceptionCondition
ArgumentNullException

socket is null.

-or-

host is null.

ArgumentOutOfRangeExceptionport is not between 0 and 65535.
ArgumentException

socket is not connected.

-or-

The host is a zero-length string.

InvalidOperationException The IMailService is already connected.
OperationCanceledException The operation was canceled via the cancellation token.
IOException An I/O error occurred.
CommandException The command was rejected by the mail server.
ProtocolException The server responded with an unexpected token.
Remarks

Asynchronously establishes a connection to the specified mail server using the provided socket.

If a successful connection is made, the AuthenticationMechanisms property will be populated.

See Also