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 |
---|---|---|
FileNumber n'existe pas. |
||
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