UdpClient.EndReceive(IAsyncResult, IPEndPoint) Método

Definição

Espaço de Nomes:
System.Net.Sockets
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Termina uma receção assíncrona pendente.

public:
 cli::array <System::Byte> ^ EndReceive(IAsyncResult ^ asyncResult, System::Net::IPEndPoint ^ % remoteEP);
public byte[] EndReceive(IAsyncResult asyncResult, ref System.Net.IPEndPoint remoteEP);
member this.EndReceive : IAsyncResult * IPEndPoint -> byte[]
Public Function EndReceive (asyncResult As IAsyncResult, ByRef remoteEP As IPEndPoint) As Byte()

Parâmetros

asyncResult
IAsyncResult

Um objeto devolvido IAsyncResult por uma chamada para BeginReceive(AsyncCallback, Object).

remoteEP
IPEndPoint

O endpoint remoto especificado.

Devoluções

Byte[]

Se for bem-sucedido, um array de bytes que contém dados de datagramas.

Exceções

ArgumentNullException

asyncResult é null.

ArgumentException

asyncResult não foi respondido por uma chamada ao BeginReceive(AsyncCallback, Object) método.

InvalidOperationException

EndReceive(IAsyncResult, IPEndPoint) foi anteriormente chamada para a leitura assíncrona.

SocketException

Ocorreu um erro ao tentar aceder ao valor subjacente Socket.

ObjectDisposedException

O subjacente Socket foi encerrado.

Exemplos

O exemplo de código seguinte é utilizado BeginSend para completar uma receção assíncrona de uma resposta de servidor.

public struct UdpState
{
    public UdpClient u;
    public IPEndPoint e;
}

public static bool messageReceived = false;

public static void ReceiveCallback(IAsyncResult ar)
{
    UdpClient u = ((UdpState)(ar.AsyncState)).u;
    IPEndPoint e = ((UdpState)(ar.AsyncState)).e;

    byte[] receiveBytes = u.EndReceive(ar, ref e);
    string receiveString = Encoding.ASCII.GetString(receiveBytes);

    Console.WriteLine($"Received: {receiveString}");
    messageReceived = true;
}

public static void ReceiveMessages()
{
    // Receive a message and write it to the console.
    IPEndPoint e = new IPEndPoint(IPAddress.Any, s_listenPort);
    UdpClient u = new UdpClient(e);

    UdpState s = new UdpState();
    s.e = e;
    s.u = u;

    Console.WriteLine("listening for messages");
    u.BeginReceive(new AsyncCallback(ReceiveCallback), s);

    // Do some work while we wait for a message. For this example, we'll just sleep
    while (!messageReceived)
    {
        Thread.Sleep(100);
    }
}

Observações

Este método bloqueia até que a operação seja concluída.

Para realizar esta operação de forma síncrona, use o Receive método.

Aplica-se a