System.SysUtils.FileOpen

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function FileOpen(const FileName: string; Mode: LongWord): THandle;

C++

extern DELPHI_PACKAGE NativeUInt __fastcall FileOpen(const System::UnicodeString FileName, unsigned Mode);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils


Beschreibung

FileOpen öffnet eine bestimmte Datei im angegebenen Zugriffsmodus.

Mit FileOpen können Sie eine Datei öffnen und ihr Datei-Handle ermitteln. Der Parameter Mode legt fest, wie die Datei geöffnet wird. Mode enthält den Öffnungsmodus und (evtl.) den Freigabemodus. Beide Werte werden mit einem logischen ODER verknüpft.

Für Öffnungsmodus-Konstanten müssen Sie einen der folgenden Werte verwenden.

Wert Bedeutung

fmExclusive

Erstellt die Datei nur automatisch, wenn sie nicht vorhanden ist, anderenfalls schlägt die Funktion fehl.

fmOpenRead

Öffnet die Datei ausschließlich zum Lesen.

fmOpenWrite

Öffnet die Datei ausschließlich zum Schreiben. Beim Schreiben in die Datei wird der aktuelle Inhalt vollständig ersetzt.

fmOpenReadWrite

Öffnet die Datei zum Ändern des aktuellen Inhalts, anstatt diesen zu ersetzen.

Für Freigabemodus-Konstanten müssen Sie einen der folgenden Werte verwenden.

Wert Bedeutung

fmShareCompat

Andere Anwendungen können auf die Datei entsprechend der FCB-Öffnungsmethode zugreifen.

fmShareExclusive

Andere Anwendungen können die Datei nicht öffnen.

fmShareDenyWrite

Andere Anwendungen können die Datei ausschließlich zum Lesen öffnen.

fmShareDenyRead

Andere Anwendungen können die Datei zum Schreiben, nicht aber zum Lesen öffnen.

fmShareDenyNone

Andere Anwendungen können die Datei ohne Einschränkungen zum Lesen oder Schreiben öffnen.

FileOpen kann Folgendes zurückgeben:

  • Einen anderen Wert als INVALID_HANDLE_VALUE, was bedeutet, dass die Funktion erfolgreich war und der Wert das Datei-Handle der geöffneten Datei ist.
  • Einen Wert gleich INVALID_HANDLE_VALUE, der anzeigt, dass ein Fehler aufgetreten ist.
Hinweis: Nicht native Delphi-Dateibehandlungsroutinen, wie FileOpen, sollten nicht verwendet werden. Diese Routinen greifen auf Systemroutinen zurück und geben Betriebssystem-Datei-Handle zurück, keine Delphi-Dateivariablen. Dabei handelt es sich um Low-Level-Routinen für den Dateizugriff. Verwenden Sie für normale Dateioperationen stattdessen AssignFile, Rewrite und Reset.

Siehe auch

Codebeispiele