System.SysUtils.FileOpen

• Aller au parent : System.SysUtils

Delphi

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

C++

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

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	System.SysUtils.pas System.SysUtils.hpp	System.SysUtils	System.SysUtils

Description

FileOpen ouvre un fichier en utilisant le mode d'accès spécifié.

Utilisez FileOpen pour ouvrir un fichier et obtenir un handle de fichier. Le paramètre Mode indique le mode d'ouverture du fichier. Le paramètre Mode est composé d'un mode d'ouverture et (éventuellement) d'un mode partagé, les deux étant combinés par un opérateur OR.

Les constantes de mode d'ouverture doivent avoir l'une des valeurs suivantes :

Valeur	Signification
fmExclusive	Crée automatiquement le fichier uniquement s'il n'existe pas, sinon échoue.
fmOpenRead	Ouvre le fichier en lecture seulement.
fmOpenWrite	Ouvre le fichier en écriture seulement. L'écriture dans le fichier remplace son contenu actuel.
fmOpenReadWrite	Ouvre le fichier pour modifier le contenu en cours plutôt que de le remplacer.

Les constantes de mode de partage doivent avoir l'une des valeurs suivantes :

Valeur	Signification
fmShareCompat	Le partage est compatible avec la manière dont les FCB sont ouverts.
fmShareExclusive	En aucun cas une autre application ne peut ouvrir le fichier.
fmShareDenyWrite	Les autres applications peuvent ouvrir le fichier en lecture, mais pas en écriture.
fmShareDenyRead	Les autres applications peuvent ouvrir le fichier en écriture, mais pas en lecture.
fmShareDenyNone	Aucune tentative n'est effectuée pour empêcher les autres applications de lire ou d'écrire dans le fichier.

FileOpen peut renvoyer :

• Une valeur différente de INVALID_HANDLE_VALUE, ce qui signifie que la fonction s'est bien déroulée. Dans ce cas, la valeur représente le handle de fichier du fichier ouvert.
• Une valeur égale à INVALID_HANDLE_VALUE, ce qui signifie qu'une erreur s'est produite.

Remarque: Nous ne conseillons pas l'utilisation de gestionnaires de fichiers en langage Delphi non natif, tels que FileOpen. Ces routines correspondent aux routines système et renvoient des handles de fichier OS, pas des variables de fichier Delphi normales. Il s'agit de routines d'accès au fichier de bas niveau. Pour des opérations normales sur les fichiers, utilisez plutôt AssignFile, Rewrite et Reset.

Voir aussi

• FileClose
• FileCreate
• AssignFile
• Rewrite
• Reset
• Support des entrées et des sorties des fichiers

Exemples de code

• FileListBox (Delphi)
• FileOpen (C++)
• FileOpen (Delphi)
• FileRead (Delphi)
• FileToGrid (C++)
• FileToGrid (Delphi)
• SysUtilsFileOpen (C++)