UdpAnySourceMulticastClient.BeginSendTo Méthode

Définition

Espace de noms:

System.Net.Sockets

Assembly:

System.Net.dll

Attention

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

Commence l’opération d’envoi d’un paquet de monodiffusion à la destination spécifiée.

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 -> IAsyncResult

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

Paramètres

buffer

Byte[]

Mémoire tampon qui contient les données à envoyer.

offset

Int32

Décalage, en octets, en partant du début de buffer pour lire les données à envoyer.

count

Int32

Nombre d’octets à envoyer à partir de buffer.

remoteEndPoint

IPEndPoint

Point de terminaison distant auquel le paquet doit être envoyé.

callback

AsyncCallback

Méthode de rappel à appeler quand l’opération se termine.

state

Object

Informations d’état facultatives à passer à la méthode callback pour cette opération.

Retours

IAsyncResult

IAsyncResult qui fait référence à cette opération.

Attributs

ObsoleteAttribute

Exceptions

ArgumentNullException

buffer est une référence Null (Nothing en Visual Basic).

ArgumentOutOfRangeException

offset est inférieur à 0.

- ou -

offset est supérieur à la longueur de buffer.

- ou -

count est inférieur à 0.

- ou -

offset plus count est supérieur à la longueur de buffer.

InvalidOperationException

Le groupe de multidiffusion n’a pas encore été joint.

ObjectDisposedException

UdpAnySourceMulticastClient a été supprimé.

SocketException

Une erreur s’est produite pendant la tentative d’accès au socket.

Remarques

La BeginSendTo méthode commence une opération d’envoi d’un paquet UDP au groupe de multidiffusion joint.

Le client doit avoir terminé une jointure au groupe de multidiffusion. L’adresse de destination spécifiée dans le remoteEndPoint paramètre doit avoir déjà envoyé un paquet de multidiffusion à ce récepteur. Certains protocoles utilisent ces informations pour transmettre le contrôle de flux, les statistiques de qualité du service ou les messages de récupération.

La méthode spécifiée dans le callback paramètre est appelée lorsqu’un paquet a reçu.

La transmission n’est autorisée que si l’adresse spécifiée dans le remoteEndPoint paramètre a déjà envoyé un paquet de multidiffusion à ce récepteur. Si le client n’est pas autorisé à accéder, un SocketException est levée avec AccessDenied.

Si le port de destination spécifié dans le remoteEndPoint paramètre est inférieur à 1 024, un SocketException est levée avec AccessDenied.

Il est possible d’avoir un échec de socket si une opération de réception échoue de manière synchrone, bien que cela soit rare avec UDP. Si un échec de socket se produit, un SocketException est levée. L’erreur reçue est spécifiée en tant que membre de l’énumération SocketError .