L'objet TextStream obtenu à l'aide d'une méthode de l'objet FileSystemObject (CreateTextStream ou OpenTextStream) ou via la méthode OpenAsTextStream de l'objet File. Il permet de lire ou écrire dans un fichier en mode texte, avec un accès séquentiel (ligne par ligne).
Pour utiliser un objet TextStream il suffit de :
Set objetFSO = CreateObject("Scripting.FileSystemObjet)Set Flux = objetFSO.OpenTextStream("c:\monfichier", 1)Wscript.Echo Flux.ReadAll()
Voici un récapitulatif des collections, propriétés et méthodes de l'objet TextStream :
| Objet TextStream | ||
|---|---|---|
| Collections | Propriétés | Méthodes |
| AtEndOfLine
AtEndOfStream Column Line |
Close
Read ReadAll ReadLine SkipLine Write WriteLine WriteblankLines | |
Lors dl'accès à un fichier par une méthode de l'objet TextStream, un pointeur permet d'indiquer la progression de la lecture du fichier.
L'objet TextStream possède un certain nombre de propriétés permettant d'obtenir des informations sur la position du pointeur. Les propriétés sont les suivantes :
| Propriété | Description |
|---|---|
| AtEndOfLine | Retourne un booléen (True ou False) indiquant si une fin de ligne est atteinte (pointeur situé immédiatement avant le caractère de saut de ligne) |
| AtEndOfStream | Retourne un booléen (True ou False) indiquant si la fin de fichier est atteinte (pointeur situé immédiatement avant le dernier caractère) |
| Column | Retourne la position du pointeur (numéro de caractère) par rapport au début de la ligne en cours |
| Line | Retourne le numéro de la ligne courante (où se trouve le pointeur). |
Les méthodes de l'objet TextStream sont les suivantes :
| Méthode | Description |
|---|---|
| Close() | Permet de fermer le fichier en cours. |
| Read(number) | Retourne une chaîne contenant le nombre de caractères précisé en argument (number), lue à partir de la position courante dans le fichier en cours. |
| ReadAll() | Retourne une chaîne contenant tous les caractères du fichiers en cours. |
| ReadLine() | Retourne une chaîne contenant tous les caractères de la ligne courante du fichiers en cours. |
| Skip(number) | Permet de sauter un nombre de caractères spécifié en argument (number) |
| SkipLine() | Permet d'ignorer la ligne courante. |
| Write(string) | Ecrit la chaîne de caractères passée en argument (string) dans le fichier en cours. |
| WriteblankLines(number) | Ecrit le nombre de lignes vides spécifié en argument (number) dans le fichier en cours. |