Socket.SendAsync(SocketAsyncEventArgs) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Verzendt gegevens asynchroon naar een verbonden Socket object.
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 BooleanParameters
Het SocketAsyncEventArgs object dat moet worden gebruikt voor deze asynchrone socketbewerking.
Retouren
true als de I/O-bewerking in behandeling is. De Completed gebeurtenis voor de e parameter wordt gegenereerd na voltooiing van de bewerking.
false als de I/O-bewerking synchroon is voltooid. In dit geval wordt de Completed gebeurtenis voor de e parameter niet gegenereerd en kan het e object dat als parameter wordt doorgegeven, direct worden onderzocht nadat de methodeaanroep terugkeert om het resultaat van de bewerking op te halen.
Uitzonderingen
De Buffer of BufferList eigenschappen van de e parameter moeten verwijzen naar geldige buffers. Een of de andere van deze eigenschappen kan worden ingesteld, maar niet beide tegelijk.
Er is al een socketbewerking uitgevoerd met behulp van het SocketAsyncEventArgs object dat is opgegeven in de e parameter.
De Socket is gesloten.
De Socket is nog niet verbonden of is niet verkregen via een Accept(), AcceptAsync(SocketAsyncEventArgs)of BeginAccept- methode.
Opmerkingen
De SendAsync methode wordt gebruikt voor het schrijven van uitgaande gegevens uit een of meer buffers op een verbindingsgeoriënteerde socket. Deze methode kan ook worden gebruikt voor verbindingsloze sockets die een externe host hebben opgegeven bij een verbindingsbewerking.
Met SendAsync de methode wordt een asynchrone verzendbewerking gestart naar de externe host die is ingesteld in de Acceptmethode , AcceptAsync, BeginAccept, BeginConnectof ConnectConnectAsync .
De volgende eigenschappen en gebeurtenissen op het System.Net.Sockets.SocketAsyncEventArgs object zijn vereist om deze methode aan te roepen:
SocketAsyncEventArgs.Buffer of SocketAsyncEventArgs.BufferList
SocketAsyncEventArgs.Count als SocketAsyncEventArgs.Buffer is ingesteld
SocketAsyncEventArgs.Offset als SocketAsyncEventArgs.Buffer is ingesteld
De aanroeper kan de SocketAsyncEventArgs.UserToken eigenschap instellen op een gewenst gebruikersstatusobject voordat de SendAsync methode wordt aangeroepen, zodat de gegevens kunnen worden opgehaald in de callback-methode. Als de callback meer informatie nodig heeft dan één object, kan er een kleine klasse worden gemaakt om de andere vereiste statusgegevens als leden te bewaren.
De SendAsync methode genereert een uitzondering als u niet eerst aanroept Accept, , BeginAcceptAcceptAsyncBeginConnect, of .ConnectAsyncConnect
Als u de SendAsync methode aanroept, kunt u gegevens verzenden binnen een afzonderlijke uitvoeringsthread.
Voor berichtgeoriënteerde sockets mag u de maximale berichtgrootte van de onderliggende Windows sockets-serviceprovider niet overschrijden. Als de gegevens te lang zijn om atomisch door te geven via de onderliggende serviceprovider, worden er geen gegevens verzonden en wordt met de SendAsync methode een SocketException met de SocketAsyncEventArgs.SocketError set naar de systeemeigen Winsock WSAEMSGSIZE-foutcode (10040) gegenereerd.
Houd er rekening mee dat de geslaagde voltooiing van de SendAsync methode niet aangeeft dat de gegevens zijn geleverd.