Partager via


Input, fonction

Mise à jour : novembre 2007

Lit des données dans un fichier séquentiel ouvert et les assigne à des variables.

Public Sub Input( _
   FileNumber As Integer, _
   ByRef Value As Object _
)

Paramètres

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

  • Value
    Requis. Variable à laquelle sont assignées les valeurs lues dans le fichier. Ne peut être une variable tableau ou objet.

Exceptions

Type d'exception

Numéro de l'erreur

Condition

IOException

52

FileNumber n'existe pas.

IOException

54

Le mode de fichier est non valide.

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'erreur par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

La fonction Input 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 Input sont généralement écrites dans un fichier avec la fonction Write. N'utilisez cette fonction qu'avec des fichiers ouverts en mode Input ou Binary.

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.

Lorsqu'elles sont lues, les chaînes standard ou les données numériques sont assignées à des variables sans être modifiées. Le tableau suivant indique comment les autres données d'entrée sont traitées.

Données

Valeur assignée à la variable

Virgule de séparation ou ligne vide

Vide

#NULL#

DBNull

#TRUE# ou #FALSE#

True ou False

#yyyy-mm-ddhh:mm:ss#

Date et/ou heure représentées par l'expression

#ERROR errornumber#

errornumber (la variable est un objet avec les mêmes balises qu'une erreur)

Si la fin du fichier est atteinte pendant l'entrée d'un élément de données, cela met fin à l'entrée et une erreur se produit.

Remarque :

La fonction Input n'est pas localisée. Donc, dans la version allemande, si vous entrez 3,14159, seule la valeur 3 sera retournée puisque la virgule est considérée comme un séparateur de variable et non comme une virgule décimale.

Note de sécurité :

La lecture d'un fichier à l'aide de la fonction Input requiert l'accès Read à partir de l'énumération FileIOPermissionAccess. Pour plus d'informations, consultez FileIOPermissionAccess, énumération.

Exemple

Cet exemple utilise la fonction Input pour lire les données d'un fichier et les placer dans deux variables. Cet exemple suppose que le fichier TestFile contient quelques lignes de données écrites à l'aide de la fonction Write, chaque ligne contenant une chaîne entre guillemets et un nombre, séparés par une virgule, par exemple ("Hello", 234).

FileOpen(1, "TESTFILE", OpenMode.Output)
Write(1, "hello")
Write(1, 14)
FileClose(1)
Dim s As String = "teststring"
Dim i As Integer 
FileOpen(1, "TESTFILE", OpenMode.Input)
Input(1, s)
MsgBox(s)
Input(1, i)
MsgBox(i)
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 : insérer du texte dans des fichiers dans Visual Basic

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

Référence

InputString, fonction

FileOpen, fonction

Fonctions Print, PrintLine

Write, WriteLine, fonctions

Autres ressources

Accès au fichier avec Visual Basic