Socket.EndSendTo(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 an einen bestimmten Speicherort.
public:
int EndSendTo(IAsyncResult ^ asyncResult);
public int EndSendTo(IAsyncResult asyncResult);
member this.EndSendTo : IAsyncResult -> int
Public Function EndSendTo (asyncResult As IAsyncResult) As Integer
Parameter
- asyncResult
- IAsyncResult
Ein IAsyncResult Objekt, das Zustandsinformationen und alle benutzerdefinierten Daten für diesen asynchronen Vorgang speichert.
Gibt zurück
Wenn die Anzahl der gesendeten Bytes erfolgreich ist; andernfalls ist ein ungültiger Fehler aufgetreten Socket .
Ausnahmen
asyncResult ist null.
asyncResult wurde nicht von einem Aufruf der BeginSendTo(Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object) Methode zurückgegeben.
EndSendTo(IAsyncResult) wurde zuvor für das asynchrone Senden aufgerufen.
Beim Versuch, auf den Socket zuzugreifen, ist ein Fehler aufgetreten.
- oder -
.NET 7+ nur: Die Socket Datei wurde geschlossen.
.NET Framework, .NET Core und .NET 5-6: 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.
EndSendTo schließt den Vorgang ab, der von BeginSendTo. Sie müssen den IAsyncResult vom übereinstimmenden BeginSendTo Aufruf erstellten Übergeben.
Wenn Sie ein verbindungsloses Protokoll verwenden, wird blockiert, EndSendTo bis das Datagramm gesendet wird. Wenn Sie ein verbindungsorientiertes Protokoll verwenden, wird blockiert, EndSendTo bis die angeforderte Anzahl von Bytes 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 BeginSendTo 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.