System.Classes.TStream
Delphi
TStream = class(TObject)
C++
class PASCALIMPLEMENTATION TStream : public System::TObject
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| class | public | System.Classes.pas System.Classes.hpp |
System.Classes | System.Classes |
Description
TStream est la classe de base des objets flux qui permettent de lire ou d'écrire sur divers types de support de données, comme les fichiers disque ou la mémoire vive.
Utilisez des objets flux spécialisés pour lire, écrire ou copier des informations stockées dans un support donné. Chaque descendant de TStream implémente des méthodes pour transférer des informations vers et depuis un support particulier comme un fichier disque ou de la mémoire dynamique. Outre des méthodes permettant la lecture, l'écriture, la copie d'octets depuis et vers le flux, les objets flux permettent aux applications d'accéder à une position arbitraire dans le flux. Les propriétés de TStream donnent des informations sur le flux, comme sa taille ou la position en cours dans le flux.
TStream introduit également des méthodes travaillant en conjonction avec les composants et les écrivains pour manipuler avec des flux les composants des fiches simples ou dérivées. Ces méthodes sont appelées automatiquement par les routines globales qui démarrent la manipulation de composants dans les flux. Elles peuvent également être appelées directement afin de démarrer le processus du flux. Néanmoins, n'oubliez pas que la manipulation des composants par les flux nécessite deux autres objets :
- Un objet composant transmis comme paramètre aux méthodes du flux.
- Un objet écrivain, automatiquement créé par le flux, qui est associé au flux.
TStream est une classe abstraite ou, dans la terminologie C++, virtuelle pure. Elle ne doit pas être instanciée ; elle s'appuie sur des méthodes abstraites ou virtuelles pures qui doivent être redéfinies dans des classes dérivées. Les objets flux descendants, comme les flux mémoire ou les flux fichier utilisés pour la manipulation des composants, sont créés automatiquement par l'appel des fonctions globales ReadComponentRes et WriteComponentRes. Pour manipuler avec des flux d'autres types d'information, il faut choisir une classe dérivée en fonction du type de données et du type de stockage voulus. C'est-à-dire :
- TFileStream (pour l'utilisation de fichiers)
- TStringStream (pour la manipulation de chaînes en mémoire)
- TMemoryStream (pour l'utilisation d'un tampon mémoire)
- TBlobStream (pour l'utilisation de champs BLOB)
- TWinSocketStream (pour la lecture et l'écriture sur une connexion socket)
- TOleStream (pour l'utilisation d'une interface COM en lecture et écriture)