Socket.SendAsync(SocketAsyncEventArgs) 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.
Sendet Daten asynchron an ein verbundenes Socket Objekt.
public:
bool SendAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);public bool SendAsync(System.Net.Sockets.SocketAsyncEventArgs e);member this.SendAsync : System.Net.Sockets.SocketAsyncEventArgs -> boolPublic Function SendAsync (e As SocketAsyncEventArgs) As BooleanParameter
Das SocketAsyncEventArgs Objekt, das für diesen asynchronen Socketvorgang verwendet werden soll.
Gibt zurück
true wenn der E/A-Vorgang aussteht. Das Completed Ereignis für den e Parameter wird nach Abschluss des Vorgangs ausgelöst.
false wenn der E/A-Vorgang synchron abgeschlossen wurde. In diesem Fall wird das Completed Ereignis für den e Parameter nicht ausgelöst, und das e als Parameter übergebene Objekt kann sofort untersucht werden, nachdem der Methodenaufruf zurückgegeben wird, um das Ergebnis des Vorgangs abzurufen.
Ausnahmen
Die Buffer Eigenschaften BufferList für den e Parameter müssen auf gültige Puffer verweisen. Eine oder die andere dieser Eigenschaften kann festgelegt werden, aber nicht beide gleichzeitig.
Ein Socketvorgang wurde bereits mit dem SocketAsyncEventArgs im e Parameter angegebenen Objekt ausgeführt.
Das Socket wurde geschlossen.
Die Socket Ist noch nicht verbunden oder wurde nicht über eine Accept(), AcceptAsync(SocketAsyncEventArgs)oder BeginAccept, Methode erhalten.
Hinweise
Die SendAsync Methode wird verwendet, um ausgehende Daten aus einem oder mehreren Puffern in einem verbindungsorientierten Socket zu schreiben. Diese Methode kann jedoch auch für verbindungslose Sockets verwendet werden, die einen Remotehost für einen Verbindungsvorgang angegeben haben.
Die SendAsync Methode startet einen asynchronen Sendevorgang an den Remotehost, der in der Accept, AcceptAsync, BeginAccept, , BeginConnect, oder ConnectConnectAsync Methode eingerichtet ist.
Die folgenden Eigenschaften und Ereignisse für das System.Net.Sockets.SocketAsyncEventArgs Objekt sind erforderlich, um diese Methode erfolgreich aufzurufen:
SocketAsyncEventArgs.Buffer oder SocketAsyncEventArgs.BufferList
SocketAsyncEventArgs.Count wenn SocketAsyncEventArgs.Buffer festgelegt ist
SocketAsyncEventArgs.Offset wenn SocketAsyncEventArgs.Buffer festgelegt ist
Der Aufrufer kann die SocketAsyncEventArgs.UserToken Eigenschaft auf ein beliebiges Benutzerstatusobjekt festlegen, das vor dem Aufrufen der SendAsync Methode gewünscht wird, sodass die Informationen in der Rückrufmethode abgerufen werden können. Wenn der Rückruf mehr Informationen als ein einzelnes Objekt benötigt, kann eine kleine Klasse erstellt werden, um die anderen erforderlichen Statusinformationen als Member zu speichern.
Die SendAsync Methode löst eine Ausnahme aus, wenn Sie nicht zuerst aufrufen Accept, , AcceptAsync, , BeginAcceptBeginConnect, Connectoder ConnectAsync.
Durch Aufrufen der SendAsync Methode können Sie Daten in einem separaten Ausführungsthread senden.
Für nachrichtenorientierte Sockets darf die maximale Nachrichtengröße des zugrunde liegenden Windows-Sockets-Dienstanbieters nicht überschritten werden. Wenn die Daten zu lang sind, um atomisch über den zugrunde liegenden Dienstanbieter zu übergeben, werden keine Daten übertragen, und die SendAsync Methode löst eine SocketException mit dem SocketAsyncEventArgs.SocketError Satz auf den systemeigenen Winsock WSAEMSGSIZE-Fehlercode (10040) aus.
Beachten Sie, dass der erfolgreiche Abschluss der SendAsync Methode nicht angibt, dass die Daten erfolgreich übermittelt wurden.