Compartilhar via


Função InputString

Retorna um valor String contendo caracteres de um arquivo aberto nos modos Input ou Binary .

O recurso My dá a você maior produtividade e desempenho em operações de E/S de arquivos que InputString.Para obter mais informações, consulte Objeto My.Computer.FileSystem.

InputString(_
   ByVal FileNumber As Integer, _
   ByVal CharCount As Integer _
) As String

Parâmetros

  • FileNumber
    Obrigatório.Qualquer número de arquivo válido.

  • CharCount
    Obrigatório.Qualquer expressão numérica válida especificando o número de caracteres a serem lidos.

Exceções

Tipo de exceção

Número de erro

Condição

IOException

52

FileNumber não existe.

ArgumentException

5

CharCount < 0 or > 214

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

A função InputString é fornecida para compatibilidade com versões anteriores e pode impactar a performance.Para aplicações novas, o objeto My.Computer.FileSystem fornece melhor performance.Para obter mais informações, consulte Access de Arquivo com o Visual Basic.

Dados lidos com a função InputString geralmente são gravados em um arquivo com Print ou FilePut.Use esta função somente com arquivos abertos em Input ou Binary modo.

Diferente da função Input, a função InputString retorna todos os caracteres que lê, incluindo vírgulas, retornos de carro, alimentações de linha, as aspas e espaços à esquerda.

Com arquivos abertos para acesso Binary,uma tentativa para ler o arquivo usando a função InputString até que EOF retorne True gerará um erro.Use as funções LOF e Loc em vez de EOF ao ler arquivos binários com InputString,ou use FileGet quando usar a função EOF.

Observação de segurança:

Durante a leitura de arquivos, não torne as decisões sobre o conteúdo do arquivo com base no extensão de nome de arquivo.Por exemplo, o arquivo Form1.vb pode não ser um arquivo fonte do Visual Basic.

Exemplo

Este exemplo usa a função InputString para ler um caractere por vez a partir de um arquivo e imprimi-lo para a janela Output.Esse exemplo assume que MyFile é um aquivo de texto com algumas linhas com dados de teste.

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)

Anotações Developer Dispositivo Inteligente

Não há suporte para esta função.

Requisitos

Namespace: Microsoft.VisualBasic

**Módulo:**FileSystem

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Consulte também

Tarefas

Como: Gravar texto em arquivos com um StreamWriter no Visual Basic

Como: Gravar texto em arquivos no Visual Basic

Referência

Função Entrada

Outros recursos

Access de Arquivo com o Visual Basic