UdpAnySourceMulticastClient.BeginSendTo Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 qui fait référence à cette opération.
- Attributs
Exceptions
buffer
est une référence Null (Nothing en Visual Basic).
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
.
Le groupe de multidiffusion n’a pas encore été joint.
UdpAnySourceMulticastClient a été supprimé.
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 .