SocketTaskExtensions.ConnectAsync Método

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Sobrecargas

ConnectAsync(Socket, IPAddress[], Int32, CancellationToken)	Estabelece uma conexão com um host remoto, que é especificado por uma matriz de endereços IP e um número de porta.
ConnectAsync(Socket, IPAddress, Int32, CancellationToken)	Estabelece uma conexão com um host remoto, que é especificado por um endereço IP e um número de porta.
ConnectAsync(Socket, String, Int32)	Estabelece uma conexão com o host remoto. O host é especificado por um nome do host e um número da porta.
ConnectAsync(Socket, String, Int32, CancellationToken)	Estabelece uma conexão com um host remoto, que é especificado por um nome de host e um número de porta.
ConnectAsync(Socket, IPAddress, Int32)	Estabelece uma conexão com o host remoto. O host é especificado por um endereço IP e um número da porta.
ConnectAsync(Socket, EndPoint, CancellationToken)	Estabelece uma conexão com o host remoto.
ConnectAsync(Socket, EndPoint)	Estabelece uma conexão com o host remoto.
ConnectAsync(Socket, IPAddress[], Int32)	Estabelece uma conexão com o host remoto. O host é especificado por uma matriz de endereços IP e um número da porta.

ConnectAsync(Socket, IPAddress[], Int32, CancellationToken)

Origem:

SocketTaskExtensions.cs

Estabelece uma conexão com um host remoto, que é especificado por uma matriz de endereços IP e um número de porta.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::ValueTask ConnectAsync(System::Net::Sockets::Socket ^ socket, cli::array <System::Net::IPAddress ^> ^ addresses, int port, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.ValueTask ConnectAsync (this System.Net.Sockets.Socket socket, System.Net.IPAddress[] addresses, int port, System.Threading.CancellationToken cancellationToken);

static member ConnectAsync : System.Net.Sockets.Socket * System.Net.IPAddress[] * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

<Extension()>
Public Function ConnectAsync (socket As Socket, addresses As IPAddress(), port As Integer, cancellationToken As CancellationToken) As ValueTask

Parâmetros

socket

Socket

O soquete no qual a operação de conexão é executada.

addresses

IPAddress[]

Os endereços IP do host remoto.

port

Int32

O número da porta do host remoto.

cancellationToken

CancellationToken

Um token de cancelamento que pode ser usado para sinalizar que a operação assíncrona deve ser cancelada.

Retornos

ValueTask

Uma tarefa que representa a operação de conexão assíncrona.

Exceções

ArgumentNullException

O parâmetro addresses não pode ser nulo.

ArgumentException

O addresses parâmetro não pode ser uma matriz vazia.

ArgumentOutOfRangeException

port é menor que MinPort.

- ou -

port é maior que MaxPort.

InvalidOperationException

O Socket está escutando.

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

SecurityException

Um chamador mais alto na pilha de chamadas não tem permissão para a operação solicitada.

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

ConnectAsync(Socket, IPAddress, Int32, CancellationToken)

Origem:

SocketTaskExtensions.cs

Estabelece uma conexão com um host remoto, que é especificado por um endereço IP e um número de porta.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::ValueTask ConnectAsync(System::Net::Sockets::Socket ^ socket, System::Net::IPAddress ^ address, int port, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.ValueTask ConnectAsync (this System.Net.Sockets.Socket socket, System.Net.IPAddress address, int port, System.Threading.CancellationToken cancellationToken);

static member ConnectAsync : System.Net.Sockets.Socket * System.Net.IPAddress * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

<Extension()>
Public Function ConnectAsync (socket As Socket, address As IPAddress, port As Integer, cancellationToken As CancellationToken) As ValueTask

Parâmetros

socket

Socket

O soquete no qual executar a operação de conexão.

address

IPAddress

O endereço IP do host remoto.

port

Int32

O número da porta do host remoto.

cancellationToken

CancellationToken

Um token de cancelamento que pode ser usado para sinalizar que a operação assíncrona deve ser cancelada.

Retornos

ValueTask

Uma tarefa que representa a operação de conexão assíncrona.

Exceções

ArgumentNullException

O parâmetro address não pode ser nulo.

ArgumentOutOfRangeException

port é menor que MinPort.

- ou -

port é maior que MaxPort.

InvalidOperationException

O Socket está escutando.

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

SecurityException

Um chamador mais alto na pilha de chamadas não tem permissão para a operação solicitada.

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

ConnectAsync(Socket, String, Int32)

Origem:

SocketTaskExtensions.cs

Estabelece uma conexão com o host remoto. O host é especificado por um nome do host e um número da porta.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task ^ ConnectAsync(System::Net::Sockets::Socket ^ socket, System::String ^ host, int port);

public static System.Threading.Tasks.Task ConnectAsync (this System.Net.Sockets.Socket socket, string host, int port);

static member ConnectAsync : System.Net.Sockets.Socket * string * int -> System.Threading.Tasks.Task

<Extension()>
Public Function ConnectAsync (socket As Socket, host As String, port As Integer) As Task

Parâmetros

socket

Socket

O soquete no qual executar a operação de conexão.

host

String

O nome do host remoto.

port

Int32

O número da porta do host remoto.

Retornos

Task

Uma tarefa assíncrona.

Exceções

ArgumentNullException

O parâmetro host não pode ser nulo.

ArgumentOutOfRangeException

port é menor que MinPort.

- ou -

port é maior que MaxPort.

InvalidOperationException

O Socket está escutando.

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

SecurityException

Um chamador mais alto na pilha de chamadas não tem permissão para a operação solicitada.

ConnectAsync(Socket, String, Int32, CancellationToken)

Origem:

SocketTaskExtensions.cs

Estabelece uma conexão com um host remoto, que é especificado por um nome de host e um número de porta.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::ValueTask ConnectAsync(System::Net::Sockets::Socket ^ socket, System::String ^ host, int port, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.ValueTask ConnectAsync (this System.Net.Sockets.Socket socket, string host, int port, System.Threading.CancellationToken cancellationToken);

static member ConnectAsync : System.Net.Sockets.Socket * string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

<Extension()>
Public Function ConnectAsync (socket As Socket, host As String, port As Integer, cancellationToken As CancellationToken) As ValueTask

Parâmetros

socket

Socket

O soquete no qual executar a operação de conexão.

host

String

O nome do host remoto.

port

Int32

O número da porta do host remoto.

cancellationToken

CancellationToken

Um token de cancelamento que pode ser usado para sinalizar que a operação assíncrona deve ser cancelada.

Retornos

ValueTask

Uma tarefa que representa uma operação de conexão assíncrona.

Exceções

ArgumentNullException

O parâmetro host não pode ser nulo.

ArgumentOutOfRangeException

port é menor que MinPort.

- ou -

port é maior que MaxPort.

InvalidOperationException

O Socket está escutando.

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

SecurityException

Um chamador mais alto na pilha de chamadas não tem permissão para a operação solicitada.

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

ConnectAsync(Socket, IPAddress, Int32)

Origem:

SocketTaskExtensions.cs

Estabelece uma conexão com o host remoto. O host é especificado por um endereço IP e um número da porta.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task ^ ConnectAsync(System::Net::Sockets::Socket ^ socket, System::Net::IPAddress ^ address, int port);

public static System.Threading.Tasks.Task ConnectAsync (this System.Net.Sockets.Socket socket, System.Net.IPAddress address, int port);

static member ConnectAsync : System.Net.Sockets.Socket * System.Net.IPAddress * int -> System.Threading.Tasks.Task

<Extension()>
Public Function ConnectAsync (socket As Socket, address As IPAddress, port As Integer) As Task

Parâmetros

socket

Socket

O soquete no qual executar a operação de conexão.

address

IPAddress

O endereço IP do host remoto.

port

Int32

O número da porta do host remoto.

Retornos

Task

Uma tarefa que representa uma operação de conexão assíncrona.

Exceções

ArgumentNullException

O parâmetro address não pode ser nulo.

ArgumentOutOfRangeException

port é menor que MinPort.

- ou -

port é maior que MaxPort.

InvalidOperationException

O Socket está escutando.

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

SecurityException

Um chamador mais alto na pilha de chamadas não tem permissão para a operação solicitada.

ConnectAsync(Socket, EndPoint, CancellationToken)

Origem:

SocketTaskExtensions.cs

Estabelece uma conexão com o host remoto.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::ValueTask ConnectAsync(System::Net::Sockets::Socket ^ socket, System::Net::EndPoint ^ remoteEP, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.ValueTask ConnectAsync (this System.Net.Sockets.Socket socket, System.Net.EndPoint remoteEP, System.Threading.CancellationToken cancellationToken);

static member ConnectAsync : System.Net.Sockets.Socket * System.Net.EndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

<Extension()>
Public Function ConnectAsync (socket As Socket, remoteEP As EndPoint, cancellationToken As CancellationToken) As ValueTask

Parâmetros

socket

Socket

O soquete usado para estabelecer uma conexão.

remoteEP

EndPoint

Um EndPoint que representa o dispositivo remoto.

cancellationToken

CancellationToken

Um token de cancelamento que pode ser usado para sinalizar que a operação assíncrona deve ser cancelada.

Retornos

ValueTask

Uma tarefa que representa a operação de conexão assíncrona.

Exceções

ArgumentNullException

O parâmetro remoteEP não pode ser nulo.

InvalidOperationException

O Socket está escutando.

SocketException

Ocorreu um erro ao tentar acessar o soquete.

NotSupportedException

O ponto de extremidade local e o remoteEP parâmetro não são a mesma família de endereços.

ObjectDisposedException

O Socket foi fechado.

SecurityException

Um chamador mais alto na pilha de chamadas não tem permissão para a operação solicitada.

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

ConnectAsync(Socket, EndPoint)

Origem:

SocketTaskExtensions.cs

Estabelece uma conexão com o host remoto.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task ^ ConnectAsync(System::Net::Sockets::Socket ^ socket, System::Net::EndPoint ^ remoteEP);

public static System.Threading.Tasks.Task ConnectAsync (this System.Net.Sockets.Socket socket, System.Net.EndPoint remoteEP);

static member ConnectAsync : System.Net.Sockets.Socket * System.Net.EndPoint -> System.Threading.Tasks.Task

<Extension()>
Public Function ConnectAsync (socket As Socket, remoteEP As EndPoint) As Task

Parâmetros

socket

Socket

O soquete usado para estabelecer uma conexão.

remoteEP

EndPoint

Um EndPoint que representa o dispositivo remoto.

Retornos

Task

Uma tarefa assíncrona.

Exceções

ArgumentNullException

O parâmetro remoteEP não pode ser nulo.

InvalidOperationException

O Socket está escutando.

SocketException

Ocorreu um erro ao tentar acessar o soquete.

NotSupportedException

O ponto de extremidade local e o remoteEP parâmetro não são a mesma família de endereços.

ObjectDisposedException

O Socket foi fechado.

SecurityException

Um chamador mais alto na pilha de chamadas não tem permissão para a operação solicitada.

ConnectAsync(Socket, IPAddress[], Int32)

Origem:

SocketTaskExtensions.cs

Estabelece uma conexão com o host remoto. O host é especificado por uma matriz de endereços IP e um número da porta.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Threading::Tasks::Task ^ ConnectAsync(System::Net::Sockets::Socket ^ socket, cli::array <System::Net::IPAddress ^> ^ addresses, int port);

public static System.Threading.Tasks.Task ConnectAsync (this System.Net.Sockets.Socket socket, System.Net.IPAddress[] addresses, int port);

static member ConnectAsync : System.Net.Sockets.Socket * System.Net.IPAddress[] * int -> System.Threading.Tasks.Task

<Extension()>
Public Function ConnectAsync (socket As Socket, addresses As IPAddress(), port As Integer) As Task

Parâmetros

socket

Socket

O soquete no qual a operação de conexão é executada.

addresses

IPAddress[]

Os endereços IP do host remoto.

port

Int32

O número da porta do host remoto.

Retornos

Task

Uma tarefa que representa a operação de conexão assíncrona.

Exceções

ArgumentNullException

O parâmetro addresses não pode ser nulo.

ArgumentException

O addresses parâmetro não pode ser uma matriz vazia.

ArgumentOutOfRangeException

port é menor que MinPort.

- ou -

port é maior que MaxPort.

InvalidOperationException

O Socket está escutando.

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

SecurityException

Um chamador mais alto na pilha de chamadas não tem permissão para a operação solicitada.