Socket.ConnectAsync Método

Origem:

Socket.cs

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

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

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

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

Parâmetros

Devoluções

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

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

Devoluções

Uma tarefa assíncrona que se completa quando a ligação é estabelecida.

Exceções

Observações

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Connect(String, Int32).

Origem:

Socket.cs

Origem:

Socket.cs

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

Devoluções

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

false se a operação de E/S fosse concluída de forma síncrona. Neste caso, o Completed evento sobre o e parâmetro não será levantado e o e objeto passado como parâmetro pode ser examinado imediatamente após o retorno da chamada ao método para recuperar o resultado da operação.

Exceções

Observações

Se estiver a usar um protocolo orientado à ligação, o método M:System.Net.Sockets.Socket.ConnectAsync(System.Net.Sockets.SocketType,System.Net.Sockets.ProtocolType,System.Net.Sockets.SocketAsyncEventArgs) inicia um pedido assíncrono para uma ligação ao host remoto. Se estiver a usar um protocolo sem conexão, ConnectAsync estabelece um host remoto predefinido especificado pelos socketType parâmetros e.protocolType

Para ser notificado da conclusão, deve criar um método de callback que implemente o delegado EventHandler<SocketAsyncEventArgs> e anexar o callback ao SocketAsyncEventArgs.Completed evento.

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

O chamador pode definir a SocketAsyncEventArgs.UserToken propriedade para qualquer objeto de estado do utilizador desejado antes de chamar o ConnectAsync método, de modo a que a informação seja recuperável no método de retorno. Se o callback precisar de mais informação do que um único objeto, pode ser criada uma pequena classe para conter as outras informações de estado necessárias como membros.

Se estiver a usar um protocolo sem ligação como o UDP, não precisa de ligar ConnectAsync antes de enviar e receber dados. Pode usar SendToAsync e ReceiveFromAsync comunicar com um host remoto. Se ligar, ConnectAsyncquaisquer datagramas que cheguem de um endereço diferente do padrão especificado serão descartados. Se quiseres mudar o host remoto predefinido, chama o ConnectAsync método novamente com o endpoint desejado.

Se desejar definir o host remoto predefinido para um endereço de broadcast, deve primeiro ligar SetSocketOption e definir o Broadcast para true. Se isto não for feito, o ConnectAsync método irá lançar um SocketException.

São necessárias as seguintes propriedades e eventos no System.Net.Sockets.SocketAsyncEventArgs objeto:

• SocketAsyncEventArgs.Completed

• SocketAsyncEventArgs.RemoteEndPoint

Opcionalmente, pode ser fornecido um buffer que será enviado atómicamente para o soquete após o sucesso do ConnectAsync método. Neste caso, a SocketAsyncEventArgs.Buffer propriedade tem de ser definida para o buffer que contém os dados a enviar e a SocketAsyncEventArgs.Count propriedade tem de ser definida para o número de bytes de dados a enviar do buffer. Uma vez estabelecida uma ligação, este buffer de dados é enviado.

Se estiver a usar um protocolo orientado à ligação e não ligar Bind antes de ligar ConnectAsync, o fornecedor de serviço subjacente atribuirá o endereço de rede local e o número de porta mais apropriados.

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

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

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

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

Devoluções

Uma tarefa assíncrona que se completa quando a ligação é estabelecida.

Exceções

Observações

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Connect(IPAddress[], Int32).

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

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

Devoluções

Uma tarefa assíncrona que se completa quando a ligação é estabelecida.

Exceções

Observações

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Connect(IPAddress, Int32).

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

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

Devoluções

Uma tarefa assíncrona que se completa quando a ligação é estabelecida.

Exceções

Observações

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Connect(String, Int32).

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

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

Devoluções

Uma tarefa assíncrona que se completa quando a ligação é estabelecida.

Exceções

Observações

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Connect(IPAddress[], Int32).

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

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

Devoluções

Uma tarefa assíncrona que se completa quando a ligação é estabelecida.

Exceções

Observações

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Connect(IPAddress, Int32).

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

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

Devoluções

Uma tarefa assíncrona que se completa quando a ligação é estabelecida.

Exceções

Observações

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Connect(EndPoint).

Origem:

Socket.cs

Origem:

Socket.cs

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

Devoluções

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

false se a operação de E/S fosse concluída de forma síncrona. Neste caso, o Completed evento sobre o e parâmetro não será levantado e o e objeto passado como parâmetro pode ser examinado imediatamente após o retorno da chamada ao método para recuperar o resultado da operação.

Exceções

Observações

Se estiver a usar um protocolo orientado à ligação, o ConnectAsync método inicia um pedido assíncrono para uma ligação ao host remoto. Se estiveres a usar um protocolo sem conexão, ConnectAsync estabelece um host remoto predefinido.

Para ser notificado da conclusão, deve criar um método de callback que implemente o delegado EventHandler<SocketAsyncEventArgs> e anexar o callback ao SocketAsyncEventArgs.Completed evento.

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

O chamador pode definir a SocketAsyncEventArgs.UserToken propriedade para qualquer objeto de estado do utilizador desejado antes de chamar o ConnectAsync método, de modo a que a informação seja recuperável no método de retorno. Se o callback precisar de mais informação do que um único objeto, pode ser criada uma pequena classe para conter as outras informações de estado necessárias como membros.

Se estiver a usar um protocolo sem ligação como o UDP, não precisa de ligar ConnectAsync antes de enviar e receber dados. Pode usar SendToAsync e ReceiveFromAsync comunicar com um host remoto. Se ligar, ConnectAsyncquaisquer datagramas que cheguem de um endereço diferente do padrão especificado serão descartados. Se quiseres mudar o host remoto predefinido, chama o ConnectAsync método novamente com o endpoint desejado.

Se desejar definir o host remoto predefinido para um endereço de broadcast, deve primeiro ligar SetSocketOption e definir o Broadcast para true. Se isto não for feito, o ConnectAsync método irá lançar um SocketException.

São necessárias as seguintes propriedades e eventos no System.Net.Sockets.SocketAsyncEventArgs objeto:

• SocketAsyncEventArgs.Completed

• SocketAsyncEventArgs.RemoteEndPoint

Opcionalmente, pode ser fornecido um buffer que será enviado atómicamente para o soquete após o sucesso do ConnectAsync método. Neste caso, a SocketAsyncEventArgs.Buffer propriedade tem de ser definida para o buffer que contém os dados a enviar e a SocketAsyncEventArgs.Count propriedade tem de ser definida para o número de bytes de dados a enviar do buffer. Uma vez estabelecida uma ligação, este buffer de dados é enviado.

Se estiver a usar um protocolo orientado à ligação e não ligar Bind antes de ligar ConnectAsync, o fornecedor de serviço subjacente atribuirá o endereço de rede local e o número de porta mais apropriados.

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

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

Ver também

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

Origem:

Socket.Tasks.cs

Origem:

Socket.Tasks.cs

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

Devoluções

Uma tarefa assíncrona que se completa quando a ligação é estabelecida.

Exceções

Observações

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Connect(EndPoint).