Freigeben über


Socket.EndSendFile(IAsyncResult) Methode

Definition

Beendet ein ausstehendes asynchrones Senden einer Datei.

public:
 void EndSendFile(IAsyncResult ^ asyncResult);
public void EndSendFile (IAsyncResult asyncResult);
member this.EndSendFile : IAsyncResult -> unit
Public Sub EndSendFile (asyncResult As IAsyncResult)

Parameter

asyncResult
IAsyncResult

Ein IAsyncResult-Objekt, das Zustandsinformation für den asynchronen Vorgang speichert.

Ausnahmen

Nur .NET 8+: Der Socket ist nicht mit einem Remotehost verbunden.

nur .NET Framework, .NET Core und .NET 5-6: Die Socket wurde geschlossen.

asyncResult ist leer.

asyncResult wurde nicht durch einen Aufruf der BeginSendFile(String, AsyncCallback, Object)-Methode zurückgegeben.

Fehler beim Versuch, auf den Socket zuzugreifen.

- oder -

Nur .NET 7+: Die Socket wurde geschlossen.

Hinweise

Wichtig

Dies ist eine Kompatibilitäts-API. Es wird nicht empfohlen, die Methoden APM (Begin* und End*) für neue Entwicklung zu verwenden. Verwenden Sie stattdessen die Task-basierten Entsprechungen.

EndSendFile schließt den von gestarteten Vorgang ab BeginSend. Sie müssen das übergeben, das IAsyncResult vom übereinstimmenden BeginSend Aufruf erstellt wurde.

Wenn Sie ein verbindungsloses Protokoll verwenden, wird blockiert, EndSendFile bis das Datagramm gesendet wird. Wenn Sie ein verbindungsorientiertes Protokoll verwenden, wird blockiert, EndSendFile bis die gesamte Datei gesendet wird. Es gibt keine Garantie, dass die von Ihnen gesendeten Daten sofort im Netzwerk angezeigt werden. Um die Netzwerkeffizienz zu erhöhen, kann das zugrunde liegende System die Übertragung verzögern, bis eine erhebliche Menge ausgehender Daten gesammelt wird. Ein erfolgreicher Abschluss der BeginSendFile Methode bedeutet, dass das zugrunde liegende System Platz zum Puffern Ihrer Daten für ein Netzwerk sendet.

Hinweis

Wenn Sie erhalten eine SocketException, verwenden die SocketException.ErrorCode Eigenschaft, um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zur Windows Sockets-API, Version 2 .

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Gilt für: