SocketTaskExtensions.ConnectAsync Método

Definição

Espaço de Nomes:: System.Net.Sockets

Assemblagens:: netstandard.dll, System.Net.Sockets.dll

Assemblagem:: System.Net.Sockets.dll

Assemblagem:: System.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Sobrecargas

Name	Description
ConnectAsync(Socket, IPAddress[], Int32, CancellationToken)	Estabelece uma ligação a um host remoto, que é especificada por um array de endereços IP e um número de porta.
ConnectAsync(Socket, IPAddress, Int32, CancellationToken)	Estabelece uma ligação a um host remoto, que é especificada por um endereço IP e um número de porta.
ConnectAsync(Socket, String, Int32)	Estabelece uma ligação a um host remoto. O host é especificado por um nome de host e um número de porta.
ConnectAsync(Socket, String, Int32, CancellationToken)	Estabelece uma ligação a um host remoto, que é especificado por um nome de host e um número de porta.
ConnectAsync(Socket, IPAddress, Int32)	Estabelece uma ligação a um host remoto. O host é especificado por um endereço IP e um número de porta.
ConnectAsync(Socket, EndPoint, CancellationToken)	Estabelece uma ligação a um host remoto.
ConnectAsync(Socket, EndPoint)	Estabelece uma ligação a um host remoto.
ConnectAsync(Socket, IPAddress[], Int32)	Estabelece uma ligação a um host remoto. O host é especificado por um array de endereços IP e um número de porta.

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

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Estabelece uma ligação a um host remoto, que é especificada por um array 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

A tomada onde a operação de ligação é realizada.

addresses: IPAddress[]

Os endereços IP do host remoto.

port: Int32

O número de porta do host remoto.

cancellationToken: CancellationToken

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

Devoluções

ValueTask

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

Exceções

ArgumentNullException

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

ArgumentException

O addresses parâmetro não pode ser um array vazio.

ArgumentOutOfRangeException

port é inferior a MinPort.

-ou-

port é maior que MaxPort.

InvalidOperationException

Está Socket a ouvir.

SocketException

Ocorreu um erro ao tentar aceder ao soquete.

ObjectDisposedException

O Socket local foi encerrado.

SecurityException

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

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

Aplica-se a

ConnectAsync(Socket, IPAddress, Int32, CancellationToken)

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Estabelece uma ligação a um host remoto, que é especificada 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

A tomada para realizar a operação de ligação.

address: IPAddress

O endereço IP do host remoto.

port: Int32

O número de porta do host remoto.

cancellationToken: CancellationToken

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

Devoluções

ValueTask

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

Exceções

ArgumentNullException

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

ArgumentOutOfRangeException

port é inferior a MinPort.

-ou-

port é maior que MaxPort.

InvalidOperationException

Está Socket a ouvir.

SocketException

Ocorreu um erro ao tentar aceder ao soquete.

ObjectDisposedException

O Socket local foi encerrado.

SecurityException

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

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

Aplica-se a

ConnectAsync(Socket, String, Int32)

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Estabelece uma ligação a um host remoto. O host é especificado por um nome de host e um número de 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

A tomada para realizar a operação de ligação.

host: String

O nome do anfitrião remoto.

port: Int32

O número de porta do host remoto.

Devoluções

Task

Uma tarefa assíncrona.

Exceções

ArgumentNullException

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

ArgumentOutOfRangeException

port é inferior a MinPort.

-ou-

port é maior que MaxPort.

InvalidOperationException

Está Socket a ouvir.

SocketException

Ocorreu um erro ao tentar aceder ao soquete.

ObjectDisposedException

O Socket local foi encerrado.

SecurityException

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

Aplica-se a

ConnectAsync(Socket, String, Int32, CancellationToken)

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Estabelece uma ligação a 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

A tomada para realizar a operação de ligação.

host: String

O nome do anfitrião remoto.

port: Int32

O número de porta do host remoto.

cancellationToken: CancellationToken

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

Devoluções

ValueTask

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

Exceções

ArgumentNullException

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

ArgumentOutOfRangeException

port é inferior a MinPort.

-ou-

port é maior que MaxPort.

InvalidOperationException

Está Socket a ouvir.

SocketException

Ocorreu um erro ao tentar aceder ao soquete.

ObjectDisposedException

O Socket local foi encerrado.

SecurityException

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

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

Aplica-se a

ConnectAsync(Socket, IPAddress, Int32)

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Estabelece uma ligação a um host remoto. O host é especificado por um endereço IP e um número de 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

A tomada para realizar a operação de ligação.

address: IPAddress

O endereço IP do host remoto.

port: Int32

O número de porta do host remoto.

Devoluções

Task

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

Exceções

ArgumentNullException

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

ArgumentOutOfRangeException

port é inferior a MinPort.

-ou-

port é maior que MaxPort.

InvalidOperationException

Está Socket a ouvir.

SocketException

Ocorreu um erro ao tentar aceder ao soquete.

ObjectDisposedException

O Socket local foi encerrado.

SecurityException

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

Aplica-se a

ConnectAsync(Socket, EndPoint, CancellationToken)

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Estabelece uma ligação a um 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

A tomada usada para estabelecer uma ligação.

remoteEP: EndPoint

Um EndPoint que representa o dispositivo remoto.

cancellationToken: CancellationToken

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

Devoluções

ValueTask

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

Exceções

ArgumentNullException

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

InvalidOperationException

Está Socket a ouvir.

SocketException

Ocorreu um erro ao tentar aceder ao soquete.

NotSupportedException

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

ObjectDisposedException

O Socket local foi encerrado.

SecurityException

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

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

Aplica-se a

ConnectAsync(Socket, EndPoint)

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Estabelece uma ligação a um 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

A tomada usada para estabelecer uma ligação.

remoteEP: EndPoint

Um EndPoint que representa o dispositivo remoto.

Devoluções

Task

Uma tarefa assíncrona.

Exceções

ArgumentNullException

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

InvalidOperationException

Está Socket a ouvir.

SocketException

Ocorreu um erro ao tentar aceder ao soquete.

NotSupportedException

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

ObjectDisposedException

O Socket local foi encerrado.

SecurityException

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

Aplica-se a

ConnectAsync(Socket, IPAddress[], Int32)

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Origem:: SocketTaskExtensions.cs

Estabelece uma ligação a um host remoto. O host é especificado por um array de endereços IP e um número de 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

A tomada onde a operação de ligação é realizada.

addresses: IPAddress[]

Os endereços IP do host remoto.

port: Int32

O número de porta do host remoto.

Devoluções

Task

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

Exceções

ArgumentNullException

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

ArgumentException

O addresses parâmetro não pode ser um array vazio.

ArgumentOutOfRangeException

port é inferior a MinPort.

-ou-

port é maior que MaxPort.

InvalidOperationException

Está Socket a ouvir.

SocketException

Ocorreu um erro ao tentar aceder ao soquete.

ObjectDisposedException

O Socket local foi encerrado.

SecurityException

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

Aplica-se a

Comentários

Esta página foi útil?