SendFile lève NotSupportedException pour les sockets sans connexion

Le comportement de la SendFile famille de méthodes pour les sockets sans connexion (par exemple, UDP) est désormais cohérent sur toutes les plateformes. Les méthodes affectées lèvent désormais une NotSupportedException sur toutes les plateformes.

Comportement précédent

Auparavant, pour un sans connexion Socket (par exemple, UDP), les comportements suivants ont été observés :

• SendFile a lancé un NotSupportedException windows, mais pas sur des plateformes de type Unix.
• Retourné ValueTask à partir d’un SendFileAsyncSocketException stocké sur toutes les plateformes.
• L’appel EndSendFile à un IAsyncResult retour a BeginSendFile jeté une SocketException sur toutes les plateformes.

Nouveau comportement

À compter de .NET 8, pour un sans connexion Socket (par exemple, UDP), les comportements suivants sont observés :

• SendFile lève une NotSupportedException sur toutes les plateformes.
• Retourné ValueTask à partir de SendFileAsync magasins a NotSupportedException sur toutes les plateformes.
• L’appel EndSendFile à un IAsyncResult retour de BeginSendFile lève une NotSupportedException sur toutes les plateformes.

Version introduite

.NET 8 RC 1

Type de changement cassant

Ce changement est un changement de comportement.

Raison de la modification

Étant donné qu’il SendFile est généralement utilisé avec de grandes quantités de données, il n’est pas judicieux de l’utiliser avec des sockets sans connexion. En outre, le comportement précédent était incohérent, jeter SocketException sur certaines plateformes, tout en réussissant sur d’autres avec un résultat imprévisible.

Action recommandée

N’utilisez SendFile pas de méthodes pour les sockets sans connexion.

API affectées

• System.Net.Sockets.Socket.SendFile
• System.Net.Sockets.Socket.SendFileAsync
• System.Net.Sockets.Socket.EndSendFile