UdpSingleSourceMulticastClient.BeginSendToSource 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 envio de um pacote de unicast para a origem especificada anteriormente.

public:
 IAsyncResult ^ BeginSendToSource(cli::array <System::Byte> ^ buffer, int offset, int count, int remotePort, 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 BeginSendToSource (byte[] buffer, int offset, int count, int remotePort, 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.BeginSendToSource : byte[] * int * int * int * AsyncCallback * obj -> IAsyncResult

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

Parâmetros

buffer

Byte[]

O buffer que contém os dados a serem enviados.

offset

Int32

O deslocamento, em bytes, do início do buffer para ler os dados a serem enviados.

count

Int32

O número de bytes a serem enviados do buffer.

remotePort

Int32

A porta remota para a qual o pacote será enviado. O endereço remoto é especificado pelo construtor UdpSingleSourceMulticastClient(IPAddress, IPAddress, Int32).

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.

- ou -

remotePort é menor que 0 ou maior que 65.535.

InvalidOperationException

O grupo de multicast ainda não foi unido.

ObjectDisposedException

O UdpSingleSourceMulticastClient foi descartado.

SocketException

Ocorreu um erro ao tentar acessar o soquete.

Comentários

O BeginSendToSource método inicia uma operação de envio de um pacote UDP para a origem especificada anteriormente.

Alguns protocolos usam essas informações para transmitir o controle de fluxo, a qualidade das estatísticas de serviço ou as mensagens de recuperação.

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

O cliente deve ter concluído uma junção ao grupo multicast.

Se a porta de destino especificada no remotePort parâmetro for menor que 1.024, uma SocketException será gerada com AccessDenied.

É possível ter uma falha de soquete se uma operação de envio 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 .