Socket.EndSendFile(IAsyncResult) Methode

Definition

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Quelle:

Socket.cs

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

NotSupportedException

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

ObjectDisposedException

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

ArgumentNullException

asyncResult ist leer.

ArgumentException

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

InvalidOperationException

EndSendFile(IAsyncResult) wurde bereits für das asynchrone BeginSendFile(String, AsyncCallback, Object) aufgerufen.

SocketException

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.