Socket.EndSendFile(IAsyncResult) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een asynchrone verzending van een bestand beëindigd.
public:
void EndSendFile(IAsyncResult ^ asyncResult);
public void EndSendFile(IAsyncResult asyncResult);
member this.EndSendFile : IAsyncResult -> unit
Public Sub EndSendFile (asyncResult As IAsyncResult)
Parameters
- asyncResult
- IAsyncResult
Een IAsyncResult object waarin statusinformatie voor deze asynchrone bewerking wordt opgeslagen.
Uitzonderingen
.NET 8+ alleen: de socket is niet verbonden met een externe host.
.NET Framework, .NET Core en .NET 5-6: de Socket is gesloten.
asyncResult is leeg.
asyncResult is niet geretourneerd door een aanroep naar de BeginSendFile(String, AsyncCallback, Object) methode.
EndSendFile(IAsyncResult) werd eerder opgeroepen voor de asynchrone BeginSendFile(String, AsyncCallback, Object).
Er is een fout opgetreden bij het openen van de socket.
– of –
.NET 7+ alleen: de Socket is gesloten.
Opmerkingen
Important
Dit is een compatibiliteits-API. Het wordt afgeraden om de APM - (Begin* en End*) methoden voor nieuwe ontwikkeling te gebruiken. Gebruik in plaats daarvan de Taskequivalenten op basis van -.
EndSendFile voltooit de bewerking die is gestart door BeginSend. U moet de IAsyncResult gemaakte door de overeenkomende BeginSend aanroep doorgeven.
Als u een verbindingsloos protocol gebruikt, EndSendFile blokkeert u totdat het datagram wordt verzonden. Als u een verbindingsgeoriënteerd protocol gebruikt, EndSendFile blokkeert u totdat het hele bestand wordt verzonden. Er is geen garantie dat de gegevens die u verzendt, onmiddellijk in het netwerk worden weergegeven. Om de netwerkefficiëntie te verhogen, kan het onderliggende systeem de overdracht vertragen totdat een aanzienlijke hoeveelheid uitgaande gegevens wordt verzameld. Een geslaagde voltooiing van de BeginSendFile methode betekent dat het onderliggende systeem ruimte heeft gehad om uw gegevens te bufferen voor een netwerk verzenden.
Note
Als u een SocketExceptionontvangt, gebruikt u de SocketException.ErrorCode eigenschap om de specifieke foutcode te verkrijgen. Nadat u deze code hebt verkregen, raadpleegt u de Windows Sockets versie 2 API-foutcode documentatie voor een gedetailleerde beschrijving van de fout.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.