Partager via


LineInput, fonction

Mise à jour : novembre 2007

Lit une ligne unique à partir d'un fichier séquentiel ouvert et l'assigne à une variable String.

Public Function LineInput(ByVal FileNumber As Integer) As String

Paramètres

  • FileNumber
    Requis. Tout numéro de fichier valide.

Exceptions

Type d'exception

Numéro de l'erreur

Condition

EndOfStreamException

62

La fin du fichier est atteinte.

IOException

52

FileNumber n'existe pas.

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion non structurée des erreurs. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreurs par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

La fonction LineInput est fournie pour une compatibilité descendante et peut avoir un impact sur la performance. Pour les applications non héritées (legacy), l'objet My.Computer.FileSystem offre de meilleures performances. Pour plus d'informations, consultez Accès au fichier avec Visual Basic.

Les données lues à l'aide de la fonction LineInput sont généralement écrites dans un fichier avec la fonction Print.

Note de sécurité :

Lors de la lecture de fichiers, ne décidez pas du contenu d'un fichier en vous basant sur l'extension de son nom. Par exemple, un fichier nommé Form1.vb peut ne pas être un fichier source Visual Basic.

La fonction LineInput lit dans un fichier un caractère à la fois jusqu'à ce qu'elle rencontre un retour chariot (Chr(13)) ou d'une séquence saut de ligne-retour chariot (Chr(13) + Chr(10)). Les séquences retour chariot-saut de ligne ne sont pas prises en compte (elles ne sont pas ajoutées à la chaîne de caractères).

Note de sécurité :

La lecture d'un fichier à l'aide de la fonction LineInput requiert l'accès Read à partir de l'énumération FileIOPermissionAccess.

Exemple

Cet exemple utilise la fonction LineInput pour lire une ligne dans un fichier séquentiel et l'assigner à une variable. Cet exemple suppose que TestFile est un fichier texte comportant quelques lignes d'exemples de données.

Dim TextLine As String
' Open file.
FileOpen(1, "TESTFILE", OpenMode.Input)
' Loop until end of file.
While Not EOF(1)
   ' Read line into variable.
   TextLine = LineInput(1)
   ' Print to the console.
   WriteLine(1, TextLine)
End While
FileClose(1)

Notes du développeur sur Smart Device

Cette fonction n'est pas prise en charge.

Configuration requise

Espace de noms :Microsoft.VisualBasic

**Module :**FileSystem

**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)

Voir aussi

Tâches

Comment : écrire du texte dans des fichiers à l'aide de Streamwriter dans Visual Basic

Comment : insérer du texte dans des fichiers dans Visual Basic

Référence

Fonctions Chr, ChrW

Input, fonction

Autres ressources

Accès au fichier avec Visual Basic