Socket.EndSendFile(IAsyncResult) 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.
Met fin à un envoi asynchrone en attente d'un fichier.
public:
void EndSendFile(IAsyncResult ^ asyncResult);public void EndSendFile (IAsyncResult asyncResult);member this.EndSendFile : IAsyncResult -> unitPublic Sub EndSendFile (asyncResult As IAsyncResult)Paramètres
- asyncResult
- IAsyncResult
Objet IAsyncResult stockant les informations d'état de cette opération asynchrone.
Exceptions
.NET 8+ uniquement : le socket n’est pas connecté à un hôte distant.
.NET Framework, .NET Core et .NET 5-6 uniquement : a Socket été fermé.
asyncResult est vide.
asyncResult n'a pas été retourné par un appel à la méthode BeginSendFile(String, AsyncCallback, Object).
EndSendFile(IAsyncResult) a été précédemment appelé pour BeginSendFile(String, AsyncCallback, Object) asynchrone.
Une erreur s’est produite pendant la tentative d’accès au socket.
- ou -
.NET 7+ uniquement : a Socket é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. Au lieu de cela, utilisez les Taskéquivalents basés sur la base.
EndSendFile termine l’opération démarrée par BeginSend. Vous devez passer le IAsyncResult créé par l’appel correspondant BeginSend .
Si vous utilisez un protocole sans connexion, EndSendFile bloque jusqu’à ce que le datagramme soit envoyé. Si vous utilisez un protocole orienté connexion, EndSendFile bloque jusqu’à ce que le fichier entier soit envoyé. Il n’est pas garanti 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 exécution réussie de la BeginSendFile méthode signifie que le système sous-jacent a eu de la place pour mettre en mémoire tampon vos données pour un envoi réseau.
Notes
Si vous recevez un SocketException, utilisez la SocketException.ErrorCode propriété pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, 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.
Notes
Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.
