UdpAnySourceMulticastClient.BeginSendTo Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Atenção
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 unicast para o destino especificado.
public:
IAsyncResult ^ BeginSendTo(cli::array <System::Byte> ^ buffer, int offset, int count, System::Net::IPEndPoint ^ remoteEndPoint, 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 BeginSendTo(byte[] buffer, int offset, int count, System.Net.IPEndPoint remoteEndPoint, 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.BeginSendTo : byte[] * int * int * System.Net.IPEndPoint * AsyncCallback * obj -> IAsyncResultPublic Function BeginSendTo (buffer As Byte(), offset As Integer, count As Integer, remoteEndPoint As IPEndPoint, callback As AsyncCallback, state As Object) As IAsyncResultParâmetros
- buffer
- Byte[]
O buffer que contém os dados a enviar.
- offset
- Int32
O deslocamento, em bytes, desde o início do buffer para ler os dados a enviar.
- count
- Int32
O número de bytes a enviar a partir do buffer.
- remoteEndPoint
- IPEndPoint
O endpoint remoto para onde o pacote deve ser enviado.
- callback
- AsyncCallback
O método de callback para invocar quando a operação termina.
- state
- Object
Informação opcional de estado para passar ao callback método desta operação.
Devoluções
E isso faz IAsyncResult referência a esta operação.
- Atributos
Exceções
buffer é uma referência nula (Nada em Visual Basic).
offset é menor que 0
-ou-
offset é maior do que o comprimento do buffer.
-ou-
count é menor que 0
-ou-
offset mais a contagem é maior do que o comprimento do buffer.
O grupo multicast ainda não foi incluído.
O UdpAnySourceMulticastClient foi descartado.
Ocorreu um erro ao tentar aceder ao soquete.
Observações
O BeginSendTo método inicia uma operação de envio de um pacote UDP para o grupo multicast junto.
O cliente deve ter completado uma junção ao grupo multicast. O endereço de destino especificado no remoteEndPoint parâmetro deve já ter enviado um pacote multicast para este recetor. Alguns protocolos usam esta informação para transmitir controlo de fluxo, estatísticas de qualidade de serviço ou mensagens de recuperação.
O método especificado no callback parâmetro é invocado quando um pacote é recebido.
A transmissão só é permitida se o endereço especificado no remoteEndPoint parâmetro já tiver enviado um pacote multicast para este recetor. Se o cliente não tiver acesso, um SocketException é lançado com AccessDenied.
Se a porta de destino especificada no remoteEndPoint parâmetro for inferior a 1.024, a SocketException é lançado com AccessDenied.
É possível que haja uma falha no soquete se uma operação de receção falhar de forma síncrona, embora isto seja pouco comum no UDP. Se ocorrer uma falha no soquete, a SocketException é lançada. O erro recebido é especificado como um membro da SocketError enumeração.
