Socket.SendAsync(SocketAsyncEventArgs) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Envoie des données de manière asynchrone à un objet connecté Socket .
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 BooleanParamètres
Objet SocketAsyncEventArgs à utiliser pour cette opération de socket asynchrone.
Retours
true si l’opération d’E/S est en attente. L’événement Completed sur le e paramètre est déclenché à l’achèvement de l’opération.
false si l’opération d’E/S s’est terminée de façon synchrone. Dans ce cas, l’événement Completed sur le e paramètre ne sera pas déclenché et l’objet e transmis en tant que paramètre peut être examiné immédiatement après l’appel de méthode pour récupérer le résultat de l’opération.
Exceptions
Le Buffer ou BufferList les propriétés du e paramètre doivent référencer des mémoires tampons valides. L’une ou l’autre de ces propriétés peut être définie, mais pas les deux en même temps.
Une opération de socket était déjà en cours à l’aide de l’objet SocketAsyncEventArgs spécifié dans le e paramètre.
Il Socket a été fermé.
L’objet Socket n’est pas encore connecté ou n’a pas été obtenu par le biais d’une Accept()méthode , ou AcceptAsync(SocketAsyncEventArgs)BeginAccept
Remarques
La SendAsync méthode est utilisée pour écrire des données sortantes à partir d’une ou plusieurs mémoires tampons sur un socket orienté connexion. Cette méthode peut également être utilisée sur des sockets sans connexion qui ont spécifié un hôte distant sur une opération de connexion.
La SendAsync méthode démarre une opération d’envoi asynchrone à l’hôte distant établi dans la Acceptméthode , , AcceptAsyncBeginAccept, BeginConnectConnectou ConnectAsync .
Les propriétés et événements suivants sur l’objet System.Net.Sockets.SocketAsyncEventArgs sont nécessaires pour appeler correctement cette méthode :
SocketAsyncEventArgs.Buffer ou SocketAsyncEventArgs.BufferList
SocketAsyncEventArgs.Count si SocketAsyncEventArgs.Buffer elle est définie
SocketAsyncEventArgs.Offset si SocketAsyncEventArgs.Buffer elle est définie
L’appelant peut définir la SocketAsyncEventArgs.UserToken propriété sur n’importe quel objet d’état utilisateur souhaité avant d’appeler la SendAsync méthode, afin que les informations soient récupérables dans la méthode de rappel. Si le rappel a besoin de plus d’informations qu’un seul objet, une petite classe peut être créée pour contenir les autres informations d’état requises en tant que membres.
La SendAsync méthode lève une exception si vous n’appelez pas d’abordAccept, , AcceptAsync, BeginAcceptBeginConnectConnectou .ConnectAsync
L’appel de la SendAsync méthode vous permet d’envoyer des données dans un thread d’exécution distinct.
Pour les sockets orientés messages, ne dépassez pas la taille maximale du message du fournisseur de services Windows sockets sous-jacent. Si les données sont trop longues pour passer atomiquement par le biais du fournisseur de services sous-jacent, aucune donnée n’est transmise et la SendAsync méthode lève une SocketException valeur avec le SocketAsyncEventArgs.SocketError code d’erreur Winsock WSAEMSGSIZE natif (10040).
Notez que la réussite de la SendAsync méthode n’indique pas que les données ont été correctement remises.