System.Classes.THandleStream.Handle

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property Handle: THandle read FHandle;

C++

__property NativeUInt Handle = {read=FHandle, nodefault};

Propriétés

Type Visibilité  Source Unité  Parent
property public
System.Classes.pas
System.Classes.hpp
System.Classes THandleStream

Description

Spécifie le handle de la ressource de communication dans laquelle le flux lit et écrit des données.

Consultez la propriété Handle pour obtenir le handle nécessaire aux fonctions de gestion de fichier. Pour lire ou écrire dans la ressource, utilisez les méthodes de l'objet THandleStream.

Handle est une propriété en lecture seule. La propriété Handle ne peut être modifiée pour faire passer le flux de handle, de lecture en écriture, ou vice versa. Par exemple, pour faire passer un handle de fichier ouvert en mode lecture seule au mode écriture, il faut :

  1. Libérer l'objet flux.
  2. Appeler FileClose pour fermer le fichier.
  3. Rouvrir le fichier en mode écriture et utiliser le handle pour créer une nouvelle instance d'un flux de handle. Il est également possible d'ouvrir un objet TFileStream pour ce fichier en demandant un flux en mode écriture.

Remarque :  Il ne faut pas appeler la fonction FileClose avec Handle après la destruction de l'objet THandleStream.

Voir aussi