FileSystem.InputString, méthode

Article
08/21/2007

Retourne une valeur String qui contient des caractères provenant 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 de fichier que InputString. Pour plus d'informations, consultez My.Computer.FileSystem, objet.

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

Syntaxe

'Déclaration
Public Shared Function InputString ( _
    FileNumber As Integer, _
    CharCount As Integer _
) As String
'Utilisation
Dim FileNumber As Integer
Dim CharCount As Integer
Dim returnValue As String

returnValue = FileSystem.InputString(FileNumber, CharCount)

public static string InputString (
    int FileNumber,
    int CharCount
)

public:
static String^ InputString (
    int FileNumber, 
    int CharCount
)

public static String InputString (
    int FileNumber, 
    int CharCount
)

public static function InputString (
    FileNumber : int, 
    CharCount : int
) : String

Paramètres

FileNumber
Obligatoire. Tout numéro de fichier valide.

CharCount
Obligatoire. Toute expression numérique valide qui spécifie le nombre de caractères à lire.

Valeur de retour

Notes

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

La fonction InputString 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 InputString sont généralement écrites dans un fichier avec 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.

Avec les fichiers ouverts pour un accès Binary, toute tentative de lire le fichier à l'aide de la fonction InputString jusqu'à ce que EOF retourne True génère une erreur. Utilisez les fonctions LOF et Loc au lieu de EOF lors de la lecture de fichiers binaires avec InputString, ou utilisez FileGet avec la fonction EOF.

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 .

Exemple

Cet exemple utilise la fonction InputString pour lire un caractère à la fois dans un fichier et l'écrire dans la fenêtre Output. Cet exemple suppose que MyFile est un fichier texte comportant quelques lignes 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)

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

InputString, fonction
Input, fonction
Accès au fichier avec Visual Basic
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

Partager via