FileSystem.LineInput(Int32) Method

public:
 static System::String ^ LineInput(int FileNumber);

public static string LineInput (int FileNumber);

static member LineInput : int -> string

Public Function LineInput (FileNumber As Integer) As String

Parameters

Returns

Reads a single line from an open sequential file and assigns it to a String variable.

Exceptions

Examples

This example uses the LineInput function to read a line from a sequential file and assign it to a variable. This example assumes that TestFile is a text file that has several lines of sample data.

Dim TextLine As String
' Open file.
FileOpen(1, "TESTFILE", OpenMode.Input)
' Loop until end of file.
While Not EOF(1)
    ' Read line into variable.
    TextLine = LineInput(1)
    ' Print to the console.
    Console.WriteLine("1", TextLine)
End While
FileClose(1)

Remarks

The LineInput function is provided for backward compatibility and may affect performance. For non-legacy applications, the My.Computer.FileSystem object provides better performance. For more information, see File Access with Visual Basic.

Data read with LineInput is usually written to a file by using Print.

The LineInput function reads from a file one character at a time until it encounters a carriage return (Chr(13)) or carriage return/line feed (Chr(13) + Chr(10)) sequence. Carriage return/line feed sequences are skipped instead of appended to the character string.

Applies to

See also

• Chr(Int32)
• ChrW(Int32)
• Input
• File Access with Visual Basic
• How to: Write Text to a File with a Streamwriter (Visual Basic)
• How to: Write Text to Files in Visual Basic