Função Entrada
Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.
Public Sub Input( _
FileNumber As Integer, _
ByRef Value As Object _
)
Parâmetros
FileNumber
Obrigatório.Qualquer número de arquivo válido.Value
Obrigatório.Variável que é atribuída aos valores lidos do arquivo — não pode ser uma matriz ou variável de objeto.
Exceções
Tipo de exceção |
Número de erro |
Condição |
|---|---|---|
FileNumber não existe. |
||
Modo de arquivo é inválido. |
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 Input é 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 Input geralmente são escritos em um arquivo com Write.Use esta função somente com arquivos abertos em Input ou Binary modo.
.gif "Observação de segurança") 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. |
Quando lidos, sequência padrão ou dados numéricos é atribuído a variáveis sem modificação.A tabela a seguir ilustra como outros dados de entrada é tratado.
Dados |
Valor atribuído à variável |
|---|---|
Que delimita vírgula ou linha vazia |
Vazio |
# Null # |
DBNull |
# # Verdadeiro ou Falso # # |
True ou False |
#yyyy-mm-ddhh:mm:ss# |
A data e / ou hora representada pela expressão |
# Erro de errornumber# |
errornumber (variável é um objeto marcado como um erro) |
Se você atingir o final do arquivo enquanto você estiver inserindo um item de dados, a entrada seja finalizada e ocorrerá um erro.
.gif "Observação") Observação: |
|---|
O Input função não foi localizada. Por exemplo, na versão em alemão, se você entrada 3,14159, retornará somente 3, desde que a vírgula é tratado como um separador variável em vez de um ponto decimal. |
| Observação de segurança: |
|---|
Reading um arquivo com o Input função requer Read acesso das FileIOPermissionAccess enumeração. Para obter mais informações, consulte Enumeração FileIOPermissionAccess. |
Exemplo
Este exemplo usa a função Input para ler os dados a partir de um arquivo em duas variáveis.Este exemplo assume que TestFile é um arquivo com algumas linhas de dados gravados nele usando o Write função, cada linha que contém uma seqüência de caracteres em cotações e um número separado por uma vírgula, por exemplo: (" Hello ", 234).
FileOpen(1, "TESTFILE", OpenMode.Output)
Write(1, "hello")
Write(1, 14)
FileClose(1)
Dim s As String = "teststring"
Dim i As Integer
FileOpen(1, "TESTFILE", OpenMode.Input)
Input(1, s)
MsgBox(s)
Input(1, i)
MsgBox(i)
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 no Visual Basic
Como: Gravar texto em arquivos com um StreamWriter no Visual Basic