Socket.BeginConnect Método

public:
 IAsyncResult ^ BeginConnect(System::Net::EndPoint ^ remoteEP, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginConnect(System.Net.EndPoint remoteEP, AsyncCallback callback, object state);

member this.BeginConnect : System.Net.EndPoint * AsyncCallback * obj -> IAsyncResult

Public Function BeginConnect (remoteEP As EndPoint, callback As AsyncCallback, state As Object) As IAsyncResult

Parâmetros

Devoluções

E IAsyncResult que faz referência à ligação assíncrona.

Exceções

Observações

Os protocolos orientados à ligação podem usar o BeginAccept método para começar a aceitar tentativas de ligação recebidas. A operação de aceitação resultante é representada pelo retornado IAsyncResult , mesmo que possa ser concluído de forma síncrona. Antes de chamar o BeginAccept método, deve chamá-lo Listen para ouvir e colocar em fila os pedidos de ligação recebidos.

Podes passar um callback que implementa AsyncCallback para BeginAccept seres notificado sobre a conclusão da operação de aceitação. Note que, se a pilha de rede subjacente completar a operação de forma síncrona, o callback pode ser executado em linha, durante a chamada para BeginAccept. Neste caso, a CompletedSynchronously propriedade no retorno IAsyncResult será definida para true indicar que o método foi concluído de forma síncrona. Use a AsyncState propriedade de para IAsyncResult obter o objeto de estado passado para o BeginAccept método.

A BeginAccept operação deve ser realizada chamando o EndAccept método. Normalmente, o método é invocado pelo delegado fornecido AsyncCallback . EndAccept irá bloquear o thread que chama até que a operação seja concluída.

Para cancelar uma chamada pendente para o BeginAccept método, feche o Socket. Quando o Close método é chamado enquanto uma operação assíncrona está em curso, o callback fornecido ao BeginAccept método é chamado. Uma chamada subsequente ao método EndAccept lançará um ObjectDisposedException (antes do .NET 7) ou um SocketException (no .NET 7+) para indicar que a operação foi cancelada.

Ver também

• AsyncCallback
• EndConnect(IAsyncResult)
• BeginSendTo(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• BeginReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• Organizar um Delegado como Método de Retorno
• Exemplo de Soquete Cliente Assíncrono
• Exemplo de Soquete de Servidor Assíncrono

public:
 IAsyncResult ^ BeginConnect(System::Net::IPAddress ^ address, int port, AsyncCallback ^ requestCallback, System::Object ^ state);

public IAsyncResult BeginConnect(System.Net.IPAddress address, int port, AsyncCallback requestCallback, object state);

member this.BeginConnect : System.Net.IPAddress * int * AsyncCallback * obj -> IAsyncResult

Public Function BeginConnect (address As IPAddress, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parâmetros

Devoluções

E IAsyncResult que faz referência à ligação assíncrona.

Exceções

Observações

Se estiver a usar um protocolo orientado à ligação, o BeginConnect método inicia um pedido assíncrono para uma ligação ao endpoit especificado pelo remoteEP parâmetro. Se estiveres a usar um protocolo sem conexão, BeginConnect estabelece um host remoto predefinido.

Pode passar um callback que implementa AsyncCallback para BeginConnect ser notificado sobre a conclusão da operação de ligação. Note que, se a pilha de rede subjacente completar a operação de forma síncrona, o callback pode ser executado em linha, durante a chamada para BeginConnect. Neste caso, a CompletedSynchronously propriedade no retorno IAsyncResult será definida para true indicar que o método foi concluído de forma síncrona. Use a AsyncState propriedade de para IAsyncResult obter o objeto de estado passado para o BeginConnect método.

A BeginConnect operação deve ser realizada chamando o EndConnect método. Normalmente, o método é invocado pelo delegado fornecido AsyncCallback . EndConnect irá bloquear o thread que chama até que a operação seja concluída.

Se estiver a usar um protocolo sem ligação como o UDP, não precisa de ligar BeginConnect antes de enviar e receber dados. Pode usar BeginSendTo e BeginReceiveFrom comunicar com um host remoto. Se ligar, BeginConnectquaisquer datagramas que cheguem de um endereço diferente do padrão especificado serão descartados. Se quiser definir o seu host remoto predefinido para um endereço de broadcast, deve primeiro ligar SetSocketOption e definir o Broadcast para true. Se não conseguires, BeginConnect vais lançar um SocketException.

Se estiver a usar um protocolo orientado à ligação e não ligar Bind antes de ligar BeginConnect, 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 de rede local e um número de porta até que ligue para o BeginSend método ou ReceiveFrom . Se quiseres mudar o host remoto predefinido, chama o BeginConnect método novamente com o endpoint desejado.

Para cancelar uma chamada pendente para o BeginConnect método, feche o Socket. Quando o Close método é chamado enquanto uma operação assíncrona está em curso, o callback fornecido ao BeginConnect método é chamado. Uma chamada subsequente ao método EndConnect lançará um ObjectDisposedException (antes do .NET 7) ou um SocketException (no .NET 7+) para indicar que a operação foi cancelada.

Ver também

• AsyncCallback
• EndConnect(IAsyncResult)
• BeginSendTo(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• BeginReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• Organizar um Delegado como Método de Retorno
• Exemplo de Soquete Cliente Assíncrono
• Exemplo de Soquete de Servidor Assíncrono

public:
 IAsyncResult ^ BeginConnect(cli::array <System::Net::IPAddress ^> ^ addresses, int port, AsyncCallback ^ requestCallback, System::Object ^ state);

public IAsyncResult BeginConnect(System.Net.IPAddress[] addresses, int port, AsyncCallback requestCallback, object state);

member this.BeginConnect : System.Net.IPAddress[] * int * AsyncCallback * obj -> IAsyncResult

Public Function BeginConnect (addresses As IPAddress(), port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parâmetros

Devoluções

E IAsyncResult que faz referência às ligações assíncronas.

Exceções

Observações

Se estiver a usar um protocolo orientado à ligação, o BeginConnect método inicia um pedido assíncrono para uma ligação ao endpoit especificado pelo remoteEP parâmetro. Se estiveres a usar um protocolo sem conexão, BeginConnect estabelece um host remoto predefinido.

Pode passar um callback que implementa AsyncCallback para BeginConnect ser notificado sobre a conclusão da operação de ligação. Note que, se a pilha de rede subjacente completar a operação de forma síncrona, o callback pode ser executado em linha, durante a chamada para BeginConnect. Neste caso, a CompletedSynchronously propriedade no retorno IAsyncResult será definida para true indicar que o método foi concluído de forma síncrona. Use a AsyncState propriedade de para IAsyncResult obter o objeto de estado passado para o BeginConnect método.

A BeginConnect operação deve ser realizada chamando o EndConnect método. Normalmente, o método é invocado pelo delegado fornecido AsyncCallback . EndConnect irá bloquear o thread que chama até que a operação seja concluída.

Se estiver a usar um protocolo sem ligação como o UDP, não precisa de ligar BeginConnect antes de enviar e receber dados. Pode usar BeginSendTo e BeginReceiveFrom comunicar com um host remoto. Se ligar, BeginConnectquaisquer datagramas que cheguem de um endereço diferente do padrão especificado serão descartados. Se quiser definir o seu host remoto predefinido para um endereço de broadcast, deve primeiro ligar SetSocketOption e definir o Broadcast para true. Se não conseguires, BeginConnect vais lançar um SocketException.

Se estiver a usar um protocolo orientado à ligação e não ligar Bind antes de ligar BeginConnect, 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 de rede local e um número de porta até que ligue para o BeginSend método ou ReceiveFrom . Se quiseres mudar o host remoto predefinido, chama o BeginConnect método novamente com o endpoint desejado.

Para cancelar uma chamada pendente para o BeginConnect método, feche o Socket. Quando o Close método é chamado enquanto uma operação assíncrona está em curso, o callback fornecido ao BeginConnect método é chamado. Uma chamada subsequente ao método EndConnect lançará um ObjectDisposedException (antes do .NET 7) ou um SocketException (no .NET 7+) para indicar que a operação foi cancelada.

Ver também

• AsyncCallback
• EndConnect(IAsyncResult)
• BeginSendTo(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• BeginReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• Organizar um Delegado como Método de Retorno
• Exemplo de Soquete Cliente Assíncrono
• Exemplo de Soquete de Servidor Assíncrono

public:
 IAsyncResult ^ BeginConnect(System::String ^ host, int port, AsyncCallback ^ requestCallback, System::Object ^ state);

public IAsyncResult BeginConnect(string host, int port, AsyncCallback requestCallback, object state);

member this.BeginConnect : string * int * AsyncCallback * obj -> IAsyncResult

Public Function BeginConnect (host As String, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parâmetros

Devoluções

E IAsyncResult que faz referência à ligação assíncrona.

Exceções

Observações

Se estiver a usar um protocolo orientado à ligação, o BeginConnect método inicia um pedido assíncrono para uma ligação ao endpoit especificado pelo remoteEP parâmetro. Se estiveres a usar um protocolo sem conexão, BeginConnect estabelece um host remoto predefinido.

Pode passar um callback que implementa AsyncCallback para BeginConnect ser notificado sobre a conclusão da operação de ligação. Note que, se a pilha de rede subjacente completar a operação de forma síncrona, o callback pode ser executado em linha, durante a chamada para BeginConnect. Neste caso, a CompletedSynchronously propriedade no retorno IAsyncResult será definida para true indicar que o método foi concluído de forma síncrona. Use a AsyncState propriedade de para IAsyncResult obter o objeto de estado passado para o BeginConnect método.

A BeginConnect operação deve ser realizada chamando o EndConnect método. Normalmente, o método é invocado pelo delegado fornecido AsyncCallback . EndConnect irá bloquear o thread que chama até que a operação seja concluída.

Se estiver a usar um protocolo sem ligação como o UDP, não precisa de ligar BeginConnect antes de enviar e receber dados. Pode usar BeginSendTo e BeginReceiveFrom comunicar com um host remoto. Se ligar, BeginConnectquaisquer datagramas que cheguem de um endereço diferente do padrão especificado serão descartados. Se quiser definir o seu host remoto predefinido para um endereço de broadcast, deve primeiro ligar SetSocketOption e definir o Broadcast para true. Se não conseguires, BeginConnect vais lançar um SocketException.

Se estiver a usar um protocolo orientado à ligação e não ligar Bind antes de ligar BeginConnect, 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 de rede local e um número de porta até que ligue para o BeginSend método ou ReceiveFrom . Se quiseres mudar o host remoto predefinido, chama o BeginConnect método novamente com o endpoint desejado.

Para cancelar uma chamada pendente para o BeginConnect método, feche o Socket. Quando o Close método é chamado enquanto uma operação assíncrona está em curso, o callback fornecido ao BeginConnect método é chamado. Uma chamada subsequente ao método EndConnect lançará um ObjectDisposedException (antes do .NET 7) ou um SocketException (no .NET 7+) para indicar que a operação foi cancelada.

Ver também

• AsyncCallback
• EndConnect(IAsyncResult)
• BeginSendTo(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• BeginReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)
• Organizar um Delegado como Método de Retorno
• Exemplo de Soquete Cliente Assíncrono
• Exemplo de Soquete de Servidor Assíncrono