Socket.EndSendFile(IAsyncResult) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Beendet ein ausstehendes asynchrones Senden einer Datei.
public:
void EndSendFile(IAsyncResult ^ asyncResult);public void EndSendFile(IAsyncResult asyncResult);member this.EndSendFile : IAsyncResult -> unitPublic Sub EndSendFile (asyncResult As IAsyncResult)Parameter
- asyncResult
- IAsyncResult
Ein IAsyncResult Objekt, das Statusinformationen für diesen asynchronen Vorgang speichert.
Ausnahmen
.NET 8+ nur: Der Socket ist nicht mit einem Remotehost verbunden.
.NET Framework, .NET Core und .NET 5-6: Die Socket Datei wurde geschlossen.
asyncResult ist leer.
asyncResult wurde nicht von einem Aufruf der BeginSendFile(String, AsyncCallback, Object) Methode zurückgegeben.
EndSendFile(IAsyncResult) wurde zuvor für die asynchrone BeginSendFile(String, AsyncCallback, Object)Aufgerufen.
Beim Versuch, auf den Socket zuzugreifen, ist ein Fehler aufgetreten.
- oder -
.NET 7+ nur: Die Socket Datei wurde geschlossen.
Hinweise
Von Bedeutung
Dies ist eine Kompatibilitäts-API. Es wird nicht empfohlen, die Methoden APM (Begin* und End*) für die neue Entwicklung zu verwenden. Verwenden Sie stattdessen die Task-basierten Entsprechungen.
EndSendFile schließt den Vorgang ab, der von BeginSend. Sie müssen den IAsyncResult vom übereinstimmenden BeginSend Aufruf erstellten Übergeben.
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 besteht keine Garantie dafür, dass die 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 der Daten für ein Netzwerk-Senden hatte.
Hinweis
Wenn Sie ein SocketExceptionObjekt erhalten, verwenden Sie die SocketException.ErrorCode Eigenschaft, um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie in der Windows Sockets Version 2-API-Fehlercodedokumentation eine detaillierte Beschreibung des Fehlers.
Hinweis
Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network Tracing in .NET Framework.
