UdpSingleSourceMulticastClient.BeginReceiveFromSource Método

Definición

Espacio de nombres:

System.Net.Sockets

Ensamblado:

System.Net.dll

Precaución

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Inicia la operación de recepción de un paquete del grupo de multidifusión unido e invoca la devolución de llamada especificada cuando un paquete llegó al grupo procedente del remitente especificado.

public:
 IAsyncResult ^ BeginReceiveFromSource(cli::array <System::Byte> ^ buffer, int offset, int count, AsyncCallback ^ callback, System::Object ^ state);

[System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)]
public IAsyncResult BeginReceiveFromSource (byte[] buffer, int offset, int count, AsyncCallback callback, object state);

[<System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)>]
member this.BeginReceiveFromSource : byte[] * int * int * AsyncCallback * obj -> IAsyncResult

Public Function BeginReceiveFromSource (buffer As Byte(), offset As Integer, count As Integer, callback As AsyncCallback, state As Object) As IAsyncResult

Parámetros

buffer

Byte[]

Búfer para almacenar los datos recibidos.

offset

Int32

Desplazamiento, en bytes, desde el principio del buffer donde deberían almacenarse los datos.

count

Int32

Número máximo de bytes que se van a recibir y a almacenar en el buffer.

callback

AsyncCallback

Método de devolución de llamada que se invocará cuando se complete la operación.

state

Object

Información de estado opcional para pasar al método callback de esta operación.

Devoluciones

IAsyncResult

Elemento IAsyncResult que hace referencia a esta operación.

Atributos

ObsoleteAttribute

Excepciones

ArgumentNullException

buffer es una referencia nula (nada en Visual Basic).

ArgumentOutOfRangeException

offset es menor que 0

o bien

offset es mayor que la longitud del parámetro buffer.

o bien

count es menor que 0

o bien

offset más el recuento es mayor que la longitud del parámetro buffer.

InvalidOperationException

El grupo de multidifusión no se unió todavía.

ObjectDisposedException

Se ha eliminado UdpSingleSourceMulticastClient.

SocketException

Error al intentar acceder al socket para la recepción.

Comentarios

El BeginReceiveFromSource método comienza una operación de recepción de un paquete UDP del grupo de multidifusión unido desde un único remitente. El puerto local, el grupo de multidifusión y la dirección de origen del remitente se especifican en el UdpSingleSourceMulticastClient constructor. El cliente de multidifusión también debe haber completado una unión al grupo de multidifusión.

El método especificado en el callback parámetro se invoca cuando se ha recibido un paquete.

Es posible tener un error de socket si se produce un error en una operación de recepción de forma sincrónica, aunque esto es poco frecuente con UDP. Si se produce un error de socket, se produce una SocketException excepción . El error recibido se especifica como miembro de la SocketError enumeración.