UdpSingleSourceMulticastClient.BeginReceiveFromSource Método

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.dll

Cuidado

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

Inicia a operação de recebimento de um pacote do grupo de multicast unido e invoca o retorno de chamada especificado quando um pacote enviado por um remetente especificado é recebido pelo grupo.

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[]

O buffer para armazenar os dados recebidos.

offset

Int32

O deslocamento, em bytes, do início do buffer em que os dados devem ser armazenados.

count

Int32

O número máximo de bytes a ser recebido e armazenado no buffer.

callback

AsyncCallback

O método de retorno de chamada a ser invocado quando a operação for concluída.

state

Object

As informações opcionais de estado a serem passadas para o método callback para essa operação.

Retornos

IAsyncResult

Um IAsyncResult que faz referência a essa operação.

Atributos

ObsoleteAttribute

Exceções

ArgumentNullException

buffer é uma referência nula (Nada no Visual Basic).

ArgumentOutOfRangeException

offset é menor que 0

- ou -

offset é maior que o comprimento do buffer.

- ou -

count é menor que 0

- ou -

offset mais a contagem é maior que o comprimento do buffer.

InvalidOperationException

O grupo de multicast ainda não foi unido.

ObjectDisposedException

O UdpSingleSourceMulticastClient foi descartado.

SocketException

Ocorreu um erro ao tentar acessar o soquete para recebimento.

Comentários

O BeginReceiveFromSource método inicia uma operação de recebimento de um pacote UDP do grupo multicast unido de um único remetente. A porta local, o grupo multicast e o endereço de origem do remetente são especificados no UdpSingleSourceMulticastClient construtor. O cliente multicast também deve ter concluído uma junção ao grupo multicast.

O método especificado no callback parâmetro é invocado quando um pacote é recebido.

É possível ter uma falha de soquete se uma operação de recebimento falhar de forma síncrona, embora isso seja incomum com o UDP. Se ocorrer uma falha de soquete, um SocketException será gerado. O erro recebido é especificado como um membro da SocketError enumeração .