Partager via


InputString, fonction

Mise à jour : novembre 2007

Retourne une valeur String contenant les caractères d'un fichier ouvert en mode Input ou Binary.

La fonctionnalité My permet une meilleure productivité et de meilleures performances dans les opérations d'E/S sur fichier que InputString. Pour plus d'informations, consultez My.Computer.FileSystem, objet.

InputString(_
   ByVal FileNumber As Integer, _
   ByVal CharCount As Integer _
) As String

Paramètres

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

  • CharCount
    Requis. Toute expression numérique valide spécifiant le nombre de caractères à lire.

Exceptions

Type d'exception

Numéro de l'erreur

Condition

IOException

52

FileNumber n'existe pas.

ArgumentException

5

CharCount < 0 ou > 214.

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 InputString 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 InputString sont généralement écrites dans un fichier à l'aide de la fonction Print ou FilePut. N'utilisez cette fonction qu'avec des fichiers ouverts en mode Input ou Binary.

Contrairement à la fonction Input, la fonction InputString retourne tous les caractères lus, y compris les virgules, les retours chariot, les sauts de ligne, les guillemets et les espaces à gauche.

Dans le cas de fichiers ouverts en mode Binary, une erreur se produit si vous tentez de lire le fichier à l'aide de la fonction InputString jusqu'à ce que la fonction EOF retourne la valeur True. Utilisez les fonctions LOF et Loc au lieu de EOF pour la lecture de fichiers binaires à l'aide de InputString ou utilisez FileGet avec la fonction EOF.

Note de sécurité :

Lors de la lecture de fichiers, ne décidez pas du contenu du 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.

Exemple

Cet exemple utilise la fonction InputString pour lire un fichier caractère par caractère et l'afficher dans la fenêtre Output. Cet exemple suppose que MyFile est un fichier texte comportant quelques lignes d'exemples de données.

Dim oneChar As String
' Open file.
FileOpen(1,  "MYFILE.TXT", OpenMode.Input)
' Loop until end of file.
While Not EOF(1)
' Get one character.
oneChar = (InputString(1, 1))
' Print to the output window.
System.Console.Out.WriteLine(oneChar)
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

Input, fonction

Autres ressources

Accès au fichier avec Visual Basic