System.Classes.THandleStream.Handle

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property Handle: THandle read FHandle;

C++

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

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property public
System.Classes.pas
System.Classes.hpp
System.Classes THandleStream

Beschreibung

Bezeichnet das Handle der Datei, aus welcher der Stream liest bzw. in welche der Stream schreibt.

Den Wert von Handle benötigen Sie, wenn Sie Dateiverwaltungsfunktionen aufrufen, die ein Handle erfordern. Lese- und Schreibvorgänge aus bzw. in die Datei werden mit den Methoden von THandleStream ausgeführt.

Handle kann nur gelesen werden. Es ist also nicht möglich, durch Setzen der Eigenschaft Handle zwischen Lese- und Schreibzugriff oder umgekehrt zu wechseln. Sie müssen folgendermaßen vorgehen, wenn Sie beispielsweise von einem Datei-Handle für den Nur-Lesen-Modus zu einem Handle für den Schreiben-Modus wechseln wollen:

  1. Geben Sie das Stream-Objekt frei.
  2. Schließen Sie die Datei mit FileClose.
  3. Öffnen Sie die Datei erneut im Schreiben-Modus, und erzeugen Sie mit Hilfe des Handles eine neue Instanz eines Handle-Streams. Alternativ dazu öffnen Sie ein TFileStream-Objekt für die Datei, wobei Sie für den Stream Schreibzugriff vorgeben.

Anmerkung:  Rufen Sie die Funktion FileClose für das Handle erst dann auf, wenn das THandleStream-Objekt freigegeben wurde.

Siehe auch