System.Net.Socket.TSocket.Send

• Aller au parent : TSocket

Delphi

function Send(const Buf; Count: Integer; Flags: Integer): Integer; overload;
function Send(const Buf; Count: Integer; Flags: TSocketFlags = []): Integer; overload; inline;
function Send(const S: string; Flags: TSocketFlags = []): Integer; overload;
function Send(const B: TBytes; Offset: Integer = 0; Count: Integer = -1; Flags: TSocketFlags = []): Integer; overload;
function Send(const B: array of Byte; Offset: Integer = 0; Count: Integer = -1; Flags: TSocketFlags = []): Integer; overload;

C++

int __fastcall Send(const void *Buf, int Count, int Flags)/* overload */;
int __fastcall Send(const void *Buf, int Count, TSocketFlags Flags = TSocketFlags() )/* overload */;
int __fastcall Send(const System::UnicodeString S, TSocketFlags Flags = TSocketFlags() )/* overload */;
int __fastcall Send(const System::DynamicArray<System::Byte> B, int Offset = 0x0, int Count = 0xffffffff, TSocketFlags Flags = TSocketFlags() )/* overload */;
int __fastcall Send(const System::Byte *B, const int B_High, int Offset = 0x0, int Count = 0xffffffff, TSocketFlags Flags = TSocketFlags() )/* overload */;

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	System.Net.Socket.pas System.Net.Socket.hpp	System.Net.Socket	TSocket

Description

Envoie les données spécifiées au point de terminaison connecté.

Vous pouvez transmettre les paramètres suivants à Send :

• Buf est un pointeur vers un tampon qui contient les données à envoyer.
• Offset est un nombre d'octets à ignorer au début des données à envoyer.
• Count est la longueur (en octets) du tampon pointé par Buf, qui est également la longueur maximale des données à envoyer.
• Flags est un ensemble d'indicateurs qui influencent le comportement de Send. Pour plus d'informations, voir la documentation de la fonction send (EN) sur MSDN.

Au lieu de fournir un pointeur vers un tampon (Buf), vous pouvez fournir une chaîne (S) ou un tableau d'octets (B).

Si les données spécifiées sont correctement envoyées, Send renvoie le nombre d'octets envoyés. Si votre socket n'est pas connecté, Send renvoie -1.

Exceptions

Un appel à Send peut déclencher l'une des exceptions suivantes :

Exception	Exception.Message	Scénarios
ESocketError	Erreur de socket réseau : <message d'erreur> (<code d'erreur>), sur la fonction 'send' de l'API	Le système d'exploitation a signalé une erreur lors de l'envoi de données sur votre socket. Pour de plus amples informations, voir la documentation suivante relative au système d'exploitation sur lequel votre application était exécutée : Windows : fonction send (MSDN) (EN) OS X: send (OS X Man Pages) (EN) iOS : send (iOS Manual Pages) (EN) Android : send (Linux Programmer's Manual) (EN)
	Le type du socket n'est pas compatible avec l'appel	Vous ne pouvez pas utiliser Send sur un socket UDP. Utilisez à la place SendTo ou changez le type de votre socket.

Voir aussi

• System.Byte
• System.SysUtils.TBytes
• System.String

• System.Net.Socket.TSocket.BeginSend
• System.Net.Socket.TSocket.EndSend

• System.Net.Socket.TSocket.Accept
• System.Net.Socket.TSocket.Receive

• System.Net.Socket.TSocketStream.Write

• System.Net.Socket.TSocket.SendTo

• Fonction send (EN) (MSDN)