FileSystem.Input, méthode (Int32, Object)

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

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Sub Input ( _
    FileNumber As Integer, _
    ByRef Value As Object _
)
'Utilisation
Dim FileNumber As Integer
Dim Value As Object

FileSystem.Input(FileNumber, Value)

public static void Input (
    int FileNumber,
    ref Object Value
)

public:
static void Input (
    int FileNumber, 
    Object^% Value
)

public static void Input (
    int FileNumber, 
    /** @ref */ Object Value
)

JScript ne prend pas en charge le passage d'arguments de type valeur par référence.

Paramètres

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

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

Notes

Pour plus d'informations, consultez la rubrique Visual Basic Input, fonction.

La fonction Input est fournie pour des raisons de compatibilité descendante et peut avoir un impact sur les performances. Pour les applications non héritées (non-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.

Remarque 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 2005.

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-dd hh:mm:ss#	Date et/ou heure représentées par l'expression
#ERREUR errornumber#	errornumber (la variable est un objet référencé comme 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.

Notes

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.

Remarque de sécurité
La lecture d'un fichier avec la fonction Input requiert l'accès Read 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)

Plates-formes

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Voir aussi

Référence

FileSystem, classe
Membres FileSystem
Microsoft.VisualBasic, espace de noms

Autres ressources

Input, fonction
InputString, fonction
FileOpen, fonction
Fonctions Print, PrintLine
Fonctions Write, WriteLine
Comment : insérer du texte dans des fichiers dans Visual Basic
Accès au fichier avec Visual Basic
Comment : écrire du texte dans des fichiers à l'aide de Streamwriter dans Visual Basic