System.Classes.THandleStream.Handle
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:
- Geben Sie das Stream-Objekt frei.
- Schließen Sie die Datei mit FileClose.
- Ö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.