FileSystem.LineInput(Int32) Método

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Lê uma única linha de um ficheiro sequencial aberto e atribui-a 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 ficheiro válido.

Devoluções

String

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

Exceções

EndOfStreamException

Fim do processo alcançado.

IOException

FileNumber não existe.

Exemplos

Este exemplo usa a LineInput função para ler uma linha de um ficheiro sequencial e atribuí-la a uma variável. Este exemplo assume que TestFile é um ficheiro de texto que contém 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)

Observações

A LineInput função é fornecida para compatibilidade retrocedente e pode afetar o desempenho. Para aplicações não legadas, o My.Computer.FileSystem objeto oferece melhor desempenho. Para mais informações, consulte Acesso a ficheiros com Visual Basic.

Os dados lidos com LineInput são normalmente escritos num ficheiro usando Print.

Importante

Ao ler a partir de ficheiros, não tome decisões sobre o conteúdo de um ficheiro com base na extensão do nome do ficheiro. Por exemplo, um ficheiro com o nome Form1.vb pode não ser um ficheiro fonte Visual Basic.

A LineInput função lê de um ficheiro um carácter de cada vez até encontrar uma sequência de retorno de carro (Chr(13)) ou retorno de carroça/avanço de linha (Chr(13) + Chr(10)). As sequências de retorno de carro/avanço de linha são saltadas em vez de adicionadas à cadeia de caracteres.

Importante

Ler a partir de um ficheiro usando a LineInput função requer Read acesso a partir da FileIOPermissionAccess enumeração.

Aplica-se a

Ver também