FileSystem.LineInput(Int32) Método

Definição

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Lê uma única linha de um arquivo sequencial aberto e a atribui a uma String variável.

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

Parâmetros

FileNumber
Int32

Required. Qualquer número de arquivo válido.

Retornos

String

Lê uma única linha de um arquivo sequencial aberto e a atribui a uma String variável.

Exceções

EndOfStreamException

Fim do arquivo atingido.

IOException

FileNumber não existe.

Exemplos

Este exemplo usa a LineInput função para ler uma linha de um arquivo sequencial e atribuí-la a uma variável. Este exemplo pressupõe que TestFile seja um arquivo de texto que tenha várias linhas de dados de exemplo.

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)

Comentários

A LineInput função é fornecida para compatibilidade com versões anteriores e pode afetar o desempenho. Para aplicativos não herdados, o My.Computer.FileSystem objeto fornece melhor desempenho. Para obter mais informações, consulte File Access com Visual Basic.

Os dados lidos geralmente LineInput são gravados em um arquivo usando Print.

Importante

Ao ler arquivos, não tome decisões sobre o conteúdo de um arquivo com base na extensão de nome de arquivo. Por exemplo, um arquivo nomeado Form1.vb pode não ser um arquivo de origem Visual Basic.

A LineInput função lê de um arquivo um caractere de cada vez até encontrar uma sequência de retorno de carro (Chr(13)) ou retorno de carro/alimentação de linha (Chr(13) + Chr(10)). As sequências de retorno de carro/feed de linha são ignoradas em vez de acrescentadas à cadeia de caracteres.

Importante

A leitura de um arquivo usando a LineInput função requer Read acesso da FileIOPermissionAccess enumeração.

Aplica-se a

Confira também