System.Win.ScktComp.TWinSocketStream.Write
Delphi
function Write(const Buffer; Count: Longint): Longint; override;
C++
virtual int __fastcall Write(const void *Buffer, int Count)/* overload */;
inline int __fastcall Write(const System::DynamicArray<System::Byte> Buffer, int Offset, int Count){ return System::Classes::TStream::Write(Buffer, Offset, Count); }
inline int __fastcall Write(const System::DynamicArray<System::Byte> Buffer, int Count){ return System::Classes::TStream::Write(Buffer, Count); }
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | System.Win.ScktComp.pas System.Win.ScktComp.hpp |
System.Win.ScktComp | TWinSocketStream |
Description
Write écrit Count octets de Buffer dans la connexion de socket.
Utilisez la méthode Write pour écrire des données de Buffer dans la connexion de socket. Write renvoie le nombre d'octets transférés.
Write peut renvoyer 0 si la connexion de socket est extrêmement lente et que l'opération d'écriture n'a pu être effectuée au bout de TimeOut millisecondes. Cela garantit que la méthode Write ne va pas être bloquée indéfiniment si un problème a lieu dans la connexion de socket.
Pour éviter un dépassement de délai de la méthode Write en raison d'une connexion lente, affectez à Count une valeur basse et appelez plusieurs fois Write au lieu de faire moins d'appels avec une valeur élevée de Count.
A la différence de la méthode WriteBuffer, Write ne déclenche pas une exception si Count octets ne sont pas écrits dans la connexion de socket. Si, par exemple, la connexion est trop lente pour transférer toutes les données, Write renvoie 0 quand WriteBuffer déclenche une exception.