Microsoft Small Basic


File

L'objet File fournit des méthodes pour accéder, lire et écrire des informations dans un fichier. Par exemple, vous pouvez enregistrer des données dans un fichier, pour être réutilisées par un autre programme.

Properties

LastError

File.LastError

Obtient ou définit le message de la dernière erreur rencontrée lors d'une opération sur fichier. Cette propriété est utile pour savoir quelle méthode n'a pas fonctionnée.

Operations

ReadContents

File.ReadContents(filePath)

Ouvre et lit entièrement le contenu d'un fichier. Cette méthode est performante pour des fichiers de petite taille (inférieur à 1 Mo), mais beaucoup moins avec des fichiers de taille supérieure à 10 Mo.

filePath

Le chemin complet du fichier à lire. Un exemple de chemin complet serait c:\temp\settings.data.

Returns

L'ensemble du contenu du fichier.

WriteContents

File.WriteContents(filePath, contents)

Ouvre un fichier et lui écrit le contenu spécifié, en remplaçant le contenu original avec le nouveau contenu.

filePath

Le chemin complet du fichier dans lequel écrire. Un exemple de chemin complet serait c:\temp\settings.data.

contents

Le contenu à écrire dans le fichier spécifié.

Returns

Si l'opération réussit, cette méthode retournera "SUCCESS". Sinon elle retournera "FAILED".

ReadLine

File.ReadLine(filePath, lineNumber)

Ouvre le fichier et lit le contenu à la ligne spécifiée.

filePath

Le chemin complet du fichier (par exemple c:\temp\data.txt).

lineNumber

Le numéro de la ligne à lire.

Returns

Le texte à la ligne du fichier spécifié.

WriteLine

File.WriteLine(filePath, lineNumber, contents)

Ouvre le fichier spécifié et insert le contenu au numéro de ligne spécifié. Cette opération va écraser tout le contenu existant de la ligne spécifiée.

filePath

Le chemin complet du fichier à lire (par exemple c:\temp\data.txt).

lineNumber

Le numéro de la ligne du texte à écrire.

contents

Le contenu à écrire à la ligne spécifiée dans le fichier spécifié.

Returns

Si l'opération réussit, cette méthode retournera "SUCCESS". Sinon elle retournera "FAILED".

InsertLine

File.InsertLine(filePath, lineNumber, contents)

Ouvre le fichier spécifié et insert le contenu au numéro de ligne spécifié. Cette opération n'écrasera pas le contenu existant de la ligne spécifiée.

filePath

Le chemin complet du fichier à lire (par exemple c:\temp\data.txt).

lineNumber

Le numéro de la ligne du texte à insérer.

contents

Le contenu à insérer dans le fichier.

Returns

Si l'opération réussit, cette méthode retournera "SUCCESS". Sinon elle retournera "FAILED".

AppendContents

File.AppendContents(filePath, contents)

Ouvre le fichier spécifié et ajoute le contenu à la fin du fichier.

filePath

Le chemin complet du fichier à lire (par exemple c:\temp\data.txt).

contents

Le contenu à ajouter à la fin du fichier.

Returns

Si l'opération réussit, cette méthode retournera "SUCCESS". Sinon elle retournera "FAILED".

CopyFile

File.CopyFile(sourceFilePath, destinationFilePath)

Copie le fichier source spécifié à un autre emplacement. Si le répertoire de destination n'existe pas, il sera créé automatiquement. Les fichiers existants seront écrasés. Il est conseillé de vérifier l'existence des fichiers si vous ne souhaitez pas les écraser.

sourceFilePath

Le chemin complet du fichier à copier (par exemple c:\temp\data.txt).

destinationFilePath

L'emplacement de la destination, ou le chemin complet du fichier

Returns

Si l'opération réussit, cette méthode retournera "SUCCESS". Sinon elle retournera "FAILED".

DeleteFile

File.DeleteFile(filePath)

Supprime le fichier spécifié.

filePath

La destination ou le chemin du fichier (par exemple c:\temp\settings.data).

Returns

Si l'opération réussit, cette méthode retournera "SUCCESS". Sinon elle retournera "FAILED".

CreateDirectory

File.CreateDirectory(directoryPath)

Créé le répertoire spécifié.

directoryPath

Le chemin complet du répertoire à créer.

Returns

Si l'opération réussit, cette méthode retournera "SUCCESS". Sinon elle retournera "FAILED".

DeleteDirectory

File.DeleteDirectory(directoryPath)

Supprime le répertoire spécifié.

directoryPath

Le chemin complet du répertoire à supprimer.

Returns

Si l'opération réussit, cette méthode retournera "SUCCESS". Sinon elle retournera "FAILED".

GetFiles

File.GetFiles(directoryPath)

Obtient le chemin de tous les fichiers pour un chemin de répertoire spécifié.

directoryPath

Le répertoire dans lequel les fichiers sont recherchés.

Returns

Si l'opération réussie, cela retournera les fichiers dans un tableau, sinon cela retournera "FAILED".

GetDirectories

File.GetDirectories(directoryPath)

Obtient le chemin de tous les répertoires pour un chemin de répertoire spécifié.

directoryPath

Le répertoire dans lequel les sous-répertoires sont recherchés.

Returns

Si l'opération réussie cela retournera la liste de tous les répertoires dans un tableau, sinon cela retournera "FAILED".

GetTemporaryFilePath

File.GetTemporaryFilePath()

Créé un nouveau fichier temporaire dans le répertoire temporaire et retourne le chemin complet du fichier.

Returns

Le chemin complet du fichier temporaire.

GetSettingsFilePath

File.GetSettingsFilePath()

Obtient le chemin complet du fichier de paramètres de ce programme. Le nom du fichier de paramètres est basé sur le nom du programme et se trouve dans le répertoire du programme.

Returns

Le chemin complet du fichier de paramètres spécifique à ce programme.