Débloque entièrement ou partiellement un fichier externe. Le fichier a été préalablement bloqué par la fonction
<Variable FichierDisque>.Bloque.
Attention : Le déblocage peut être effectué uniquement si la partie à débloquer correspond à la partie bloquée.
// Ouverture d'un fichier externe
MonFichier est un FichierDisque
MonFichier = fOuvre("C:\MesRépertoires\Fichier.txt", foLectureEcriture)
SI PAS ErreurDétectée ALORS
// Blocage du fichier
ResBloque = MonFichier.Bloque()
...
// Déblocage du fichier externe
ResDébloque = MonFichier.Débloque()
FIN
Syntaxe
<Résultat> = <Fichier manipulé>.Débloque([<Premier octet à débloquer> [, <Nombre d'octets à débloquer>]])
<Résultat> : Booléen
- Vrai si le déblocage a été effectué,
- Faux dans le cas contraire.
<Fichier manipulé> : Variable de type FichierDisque
Nom de la variable de type FichierDisque initialisée avec la fonction fOuvre ou fCrée.
<Premier octet à débloquer> : Entier optionnel
Position du premier octet (caractère) à débloquer (0 correspond au premier octet du fichier).
<Nombre d'octets à débloquer> : Entier optionnel
Nombre d'octets (de caractères) à débloquer.
Remarques
Le déblocage n'a pas été effectué
La fonction
<Variable FichierDisque>.Débloque renvoie
Faux si le déblocage n'a pas été effectué. Le déblocage peut être effectué uniquement si :
- le fichier externe est ouvert.
- l'identifiant du fichier est valide.
- le fichier ou les octets à débloquer sont bloqués à l'identique. Par exemple, si seule une partie du fichier a été bloquée, cette même partie doit être débloquée. Si le fichier a été bloqué en totalité, il n'est pas possible de débloquer uniquement une partie du fichier.
- le fichier ou les octets à débloquer ont été bloqués par la même application et depuis le même poste.
Déblocage d'un fichier
- Le fichier est débloqué dans sa totalité si les paramètres <Premier octet à débloquer> et <Nombre d'octets à débloquer> ne sont pas précisés.
- Le fichier est débloqué du premier octet à débloquer (paramètre <Premier octet à débloquer>) jusqu'à la fin si le paramètre <Nombre d'octets à débloquer> n'est pas précisé.
- Un fichier bloqué (ou partiellement bloqué) sera automatiquement débloqué lors de sa fermeture.
Position dans le fichier
A l'ouverture d'un fichier, la position en cours correspond :
- soit au premier octet du fichier (par défaut),
- soit au dernier octet du fichier si le fichier est ouvert en "ajout" (constante foAjout).
La position en cours n'est pas modifiée par l'exécution de la fonction <Variable FichierDisque>.Débloque.
Classification Métier / UI : Code métier
Composante : wd280std.dll