Socket.ConnectAsync Método

Origem:

Socket.cs

Origem:

Socket.cs

Origem:

Socket.cs

public:
 static bool ConnectAsync(System::Net::Sockets::SocketType socketType, System::Net::Sockets::ProtocolType protocolType, System::Net::Sockets::SocketAsyncEventArgs ^ e);

public static bool ConnectAsync (System.Net.Sockets.SocketType socketType, System.Net.Sockets.ProtocolType protocolType, System.Net.Sockets.SocketAsyncEventArgs e);

static member ConnectAsync : System.Net.Sockets.SocketType * System.Net.Sockets.ProtocolType * System.Net.Sockets.SocketAsyncEventArgs -> bool

Public Shared Function ConnectAsync (socketType As SocketType, protocolType As ProtocolType, e As SocketAsyncEventArgs) As Boolean

Parâmetros

Retornos

true se a operação de E/S está pendente. O evento Completed no parâmetro e será acionado após a conclusão da operação.

false se a operação de E/S foi concluída de forma síncrona. Nesse caso, o evento Completed no parâmetro e não será gerado e o objeto e passado como um parâmetro poderá ser examinado imediatamente depois que a chamada do método for retornada para recuperar o resultado da operação.

Exceções

Comentários

Se você estiver usando um protocolo orientado a conexão, o método M:System.Net.Sockets.Socket.ConnectAsync(System.Net.Sockets.SocketType,System.Net.Sockets.ProtocolType,System.Net.Sockets.SocketAsyncEventArgs) iniciará uma solicitação assíncrona para uma conexão com o host remoto. Se você estiver usando um protocolo sem conexão, ConnectAsync estabelecerá um host remoto padrão especificado pelos socketType parâmetros e protocolType .

Para ser notificado sobre a conclusão, você deve criar um método de retorno de chamada que implementa o delegado EventHandler<SocketAsyncEventArgs> e anexar o retorno de chamada ao SocketAsyncEventArgs.Completed evento.

O chamador deve definir a SocketAsyncEventArgs.RemoteEndPoint propriedade para o IPEndPoint do host remoto ao qual se conectar.

O chamador pode definir a SocketAsyncEventArgs.UserToken propriedade como qualquer objeto de estado de usuário desejado antes de chamar o ConnectAsync método , para que as informações possam ser recuperadas no método de retorno de chamada. Se o retorno de chamada precisar de mais informações do que um único objeto, uma classe pequena poderá ser criada para manter as outras informações de estado necessárias como membros.

Se você estiver usando um protocolo sem conexão, como UDP, não precisará chamar ConnectAsync antes de enviar e receber dados. Você pode usar SendToAsync e ReceiveFromAsync para se comunicar com um host remoto. Se você chamar ConnectAsync, todos os datagramas que chegarem de um endereço diferente do padrão especificado serão descartados. Se você quiser alterar o host remoto padrão, chame o ConnectAsync método novamente com o ponto de extremidade desejado.

Se você quiser definir o host remoto padrão como um endereço de difusão, primeiro chame SetSocketOption e defina Difusão como true. Se isso não for feito, o ConnectAsync método gerará um SocketException.

As seguintes propriedades e eventos no System.Net.Sockets.SocketAsyncEventArgs objeto são necessários:

• SocketAsyncEventArgs.Completed

• SocketAsyncEventArgs.RemoteEndPoint

Opcionalmente, um buffer pode ser fornecido que será enviado atomicamente no soquete depois que o ConnectAsync método for bem-sucedido. Nesse caso, a SocketAsyncEventArgs.Buffer propriedade precisa ser definida como o buffer que contém os dados a serem enviados e a SocketAsyncEventArgs.Count propriedade precisa ser definida como o número de bytes de dados a serem enviados do buffer. Depois que uma conexão é estabelecida, esse buffer de dados é enviado.

Se você estiver usando um protocolo orientado a conexão e não chamar Bind antes de chamar ConnectAsync, o provedor de serviços subjacente atribuirá o endereço de rede local e o número da porta mais apropriados.

Se você estiver usando um protocolo sem conexão, o provedor de serviços não atribuirá um endereço IP de rede local e um número da porta até que você chame os SendAsync métodos ou ReceiveAsync .

O ConnectAsync método gerará se a família de endereços do Socket e o SocketAsyncEventArgs.RemoteEndPoint não forem a mesma família de endereçosNotSupportedException.

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

public:
 System::Threading::Tasks::ValueTask ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port, System::Threading::CancellationToken cancellationToken);

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

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

Public Function ConnectAsync (addresses As IPAddress(), port As Integer, cancellationToken As CancellationToken) As ValueTask

Parâmetros

Retornos

Uma tarefa assíncrona que é concluída quando a conexão é estabelecida.

Exceções

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Connect(IPAddress[], Int32).

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::String ^ host, int port, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync (string host, int port, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (host As String, port As Integer, cancellationToken As CancellationToken) As ValueTask

Parâmetros

Retornos

Uma tarefa assíncrona que é concluída quando a conexão é estabelecida.

Exceções

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Connect(String, Int32).

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPAddress ^ address, int port, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPAddress address, int port, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : System.Net.IPAddress * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (address As IPAddress, port As Integer, cancellationToken As CancellationToken) As ValueTask

Parâmetros

Retornos

Uma tarefa assíncrona que é concluída quando a conexão é estabelecida.

Exceções

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Connect(IPAddress, Int32).

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::String ^ host, int port);

public System.Threading.Tasks.Task ConnectAsync (string host, int port);

member this.ConnectAsync : string * int -> System.Threading.Tasks.Task

Public Function ConnectAsync (host As String, port As Integer) As Task

Parâmetros

Retornos

Uma tarefa assíncrona que é concluída quando a conexão é estabelecida.

Exceções

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Connect(String, Int32).

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

public:
 System::Threading::Tasks::Task ^ ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port);

public System.Threading.Tasks.Task ConnectAsync (System.Net.IPAddress[] addresses, int port);

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

Public Function ConnectAsync (addresses As IPAddress(), port As Integer) As Task

Parâmetros

Retornos

Uma tarefa assíncrona que é concluída quando a conexão é estabelecida.

Exceções

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Connect(IPAddress[], Int32).

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPAddress ^ address, int port);

public System.Threading.Tasks.Task ConnectAsync (System.Net.IPAddress address, int port);

member this.ConnectAsync : System.Net.IPAddress * int -> System.Threading.Tasks.Task

Public Function ConnectAsync (address As IPAddress, port As Integer) As Task

Parâmetros

Retornos

Uma tarefa assíncrona que é concluída quando a conexão é estabelecida.

Exceções

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Connect(IPAddress, Int32).

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::Net::EndPoint ^ remoteEP, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.EndPoint remoteEP, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : System.Net.EndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (remoteEP As EndPoint, cancellationToken As CancellationToken) As ValueTask

Parâmetros

Retornos

Uma tarefa assíncrona que é concluída quando a conexão é estabelecida.

Exceções

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Connect(EndPoint).

Origem:

Socket.cs

Origem:

Socket.cs

Origem:

Socket.cs

public:
 bool ConnectAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);

public bool ConnectAsync (System.Net.Sockets.SocketAsyncEventArgs e);

member this.ConnectAsync : System.Net.Sockets.SocketAsyncEventArgs -> bool

Public Function ConnectAsync (e As SocketAsyncEventArgs) As Boolean

Parâmetros

Retornos

true se a operação de E/S está pendente. O evento Completed no parâmetro e será acionado após a conclusão da operação.

false se a operação de E/S foi concluída de forma síncrona. Nesse caso, o evento Completed no parâmetro e não será gerado e o objeto e passado como um parâmetro poderá ser examinado imediatamente depois que a chamada do método for retornada para recuperar o resultado da operação.

Exceções

Comentários

Se você estiver usando um protocolo orientado a conexão, o ConnectAsync método iniciará uma solicitação assíncrona para uma conexão com o host remoto. Se você estiver usando um protocolo sem conexão, ConnectAsync estabelecerá um host remoto padrão.

Para ser notificado sobre a conclusão, você deve criar um método de retorno de chamada que implementa o delegado EventHandler<SocketAsyncEventArgs> e anexar o retorno de chamada ao SocketAsyncEventArgs.Completed evento.

O chamador deve definir a SocketAsyncEventArgs.RemoteEndPoint propriedade para o IPEndPoint do host remoto ao qual se conectar.

O chamador pode definir a SocketAsyncEventArgs.UserToken propriedade como qualquer objeto de estado de usuário desejado antes de chamar o ConnectAsync método , para que as informações possam ser recuperadas no método de retorno de chamada. Se o retorno de chamada precisar de mais informações do que um único objeto, uma classe pequena poderá ser criada para manter as outras informações de estado necessárias como membros.

Se você estiver usando um protocolo sem conexão, como UDP, não precisará chamar ConnectAsync antes de enviar e receber dados. Você pode usar SendToAsync e ReceiveFromAsync para se comunicar com um host remoto. Se você chamar ConnectAsync, todos os datagramas que chegarem de um endereço diferente do padrão especificado serão descartados. Se você quiser alterar o host remoto padrão, chame o ConnectAsync método novamente com o ponto de extremidade desejado.

Se você quiser definir o host remoto padrão como um endereço de difusão, primeiro chame SetSocketOption e defina Difusão como true. Se isso não for feito, o ConnectAsync método gerará um SocketException.

As seguintes propriedades e eventos no System.Net.Sockets.SocketAsyncEventArgs objeto são necessários:

• SocketAsyncEventArgs.Completed

• SocketAsyncEventArgs.RemoteEndPoint

Opcionalmente, um buffer pode ser fornecido que será enviado atomicamente no soquete depois que o ConnectAsync método for bem-sucedido. Nesse caso, a SocketAsyncEventArgs.Buffer propriedade precisa ser definida como o buffer que contém os dados a serem enviados e a SocketAsyncEventArgs.Count propriedade precisa ser definida como o número de bytes de dados a serem enviados do buffer. Depois que uma conexão é estabelecida, esse buffer de dados é enviado.

Se você estiver usando um protocolo orientado a conexão e não chamar Bind antes de chamar ConnectAsync, o provedor de serviços subjacente atribuirá o endereço de rede local e o número da porta mais apropriados.

Se você estiver usando um protocolo sem conexão, o provedor de serviços não atribuirá um endereço IP de rede local e um número da porta até que você chame os SendAsync métodos ou ReceiveAsync .

O ConnectAsync método gerará se a família de endereços do Socket e o SocketAsyncEventArgs.RemoteEndPoint não forem a mesma família de endereçosNotSupportedException.

Confira também

• SocketAsyncEventArgs
• Buffer
• Completed
• Count
• RemoteEndPoint
• UserToken

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::Net::EndPoint ^ remoteEP);

public System.Threading.Tasks.Task ConnectAsync (System.Net.EndPoint remoteEP);

member this.ConnectAsync : System.Net.EndPoint -> System.Threading.Tasks.Task

Public Function ConnectAsync (remoteEP As EndPoint) As Task

Parâmetros

Retornos

Uma tarefa assíncrona que é concluída quando a conexão é estabelecida.

Exceções

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Connect(EndPoint).