Socket.EndSendTo(IAsyncResult) Méthode

Définition

Espace de noms:

System.Net.Sockets

Assemblys:

netstandard.dll, System.Net.Sockets.dll

Source:

Socket.cs

Met fin à un envoi asynchrone en attente vers un emplacement spécifique.

public:
 int EndSendTo(IAsyncResult ^ asyncResult);

public int EndSendTo(IAsyncResult asyncResult);

member this.EndSendTo : IAsyncResult -> int

Public Function EndSendTo (asyncResult As IAsyncResult) As Integer

Paramètres

asyncResult

IAsyncResult

Qui IAsyncResult stocke les informations d’état et toutes les données définies par l’utilisateur pour cette opération asynchrone.

Retours

Int32

En cas de réussite, nombre d’octets envoyés ; sinon, une erreur non valide Socket .

Exceptions

ArgumentNullException

asyncResult a la valeur null.

ArgumentException

asyncResult n’a pas été retourné par un appel à la BeginSendTo(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object) méthode.

InvalidOperationException

EndSendTo(IAsyncResult) a été précédemment appelé pour l’envoi asynchrone.

SocketException

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

- ou -

.NET 7+ uniquement : le Socket fichier a été fermé.

ObjectDisposedException

.NET Framework, .NET Core et .NET 5-6 uniquement : le Socket fichier a été fermé.

Remarques

Important

Il s’agit d’une API de compatibilité. Nous vous déconseillons d’utiliser les méthodes APM (Begin* et End*) pour le nouveau développement. Utilisez plutôt les Taskéquivalents basés sur les valeurs.

EndSendTo termine l’opération démarrée par BeginSendTo. Vous devez passer la IAsyncResult création par l’appel correspondant BeginSendTo .

Si vous utilisez un protocole sans connexion, EndSendTo bloque jusqu’à ce que le datagramme soit envoyé. Si vous utilisez un protocole orienté connexion, EndSendTo bloque jusqu’à ce que le nombre demandé d’octets soit envoyé. Il n’existe aucune garantie que les données que vous envoyez s’affichent immédiatement sur le réseau. Pour augmenter l’efficacité du réseau, le système sous-jacent peut retarder la transmission jusqu’à ce qu’une quantité significative de données sortantes soit collectée. Une réussite de la méthode signifie que le système sous-jacent a eu de la BeginSendTo place pour mettre en mémoire tampon vos données pour un envoi réseau.

Note

Si vous recevez un SocketException, utilisez la SocketException.ErrorCode propriété pour obtenir le code d’erreur spécifique. Une fois que vous avez obtenu ce code, reportez-vous à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Note

Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.