FileSystem.Input Método

Definição

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.

Sobrecargas

Nome	Description
Input(Int32, Object)	Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.
Input(Int32, Int64)	Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.
Input(Int32, Int32)	Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.
Input(Int32, Int16)	Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.
Input(Int32, Double)	Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.
Input(Int32, Boolean)	Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.
Input(Int32, DateTime)	Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.
Input(Int32, Char)	Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.
Input(Int32, Byte)	Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.
Input(Int32, Single)	Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.
Input(Int32, Decimal)	Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.
Input(Int32, String)	Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.

Input(Int32, Object)

Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.

public:
 static void Input(int FileNumber, System::Object ^ % Value);

public static void Input(int FileNumber, ref object Value);

static member Input : int * obj -> unit

Public Sub Input (FileNumber As Integer, ByRef Value As Object)

Parâmetros

FileNumber: Int32

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

Value: Object

Required. Variável atribuída aos valores lidos do arquivo – não pode ser uma matriz ou variável de objeto.

Exceções

IOException

O modo de arquivo é inválido.

Exemplos

Este exemplo usa a Input função para ler dados de um arquivo em duas variáveis. Este exemplo pressupõe que TestFile seja um arquivo que tenha várias linhas de dados gravadas nela usando a Write função, cada linha contendo uma cadeia de caracteres entre aspas e um número separado por uma vírgula, por exemplo: ("Olá", 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)

Comentários

A Input 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 Input são gravados em um arquivo usando Write. Use essa função somente com arquivos abertos no modo ou Binary no Input modo.

Importante

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

Quando lido, a cadeia padrão ou os dados numéricos são atribuídos a variáveis sem modificação. A tabela a seguir ilustra como outros dados de entrada são tratados.

Dados	Valor atribuído à variável
Delimitar vírgula ou linha em branco	Vazio
#NULL#	`DBNull`
#TRUE# ou #FALSE#	`True` ou `False`
#`yyyy-mm-dd hh:mm:ss`#	A data e/ou hora representada pela expressão
#ERROR `errornumber`#	`errornumber` (variável é um objeto marcado como um erro)

Se você chegar ao final do arquivo enquanto estiver inserindo um item de dados, a entrada será interrompida e ocorrerá um erro.

Observação

A Input função não está localizada. Por exemplo, na versão alemã, se você inserir 3.14159, ela retornará apenas 3, pois a vírgula é tratada como um separador de variável em vez de como um ponto decimal.

Importante

A leitura de um arquivo usando a Input função requer Read acesso da FileIOPermissionAccess enumeração. Para obter mais informações, consulte FileIOPermissionAccess.

Confira também

Aplica-se a

Input(Int32, Int64)

Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.

public:
 static void Input(int FileNumber, long % Value);

public static void Input(int FileNumber, ref long Value);

static member Input : int * int64 -> unit

Public Sub Input (FileNumber As Integer, ByRef Value As Long)

Parâmetros

FileNumber: Int32

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

Value: Int64

Required. Variável atribuída aos valores lidos do arquivo – não pode ser uma matriz ou variável de objeto.

Exceções

IOException

O modo de arquivo é inválido.

Exemplos

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)

Comentários

Os dados lidos geralmente Input são gravados em um arquivo usando Write. Use essa função somente com arquivos abertos no modo ou Binary no Input modo.

Importante

Quando lido, a cadeia padrão ou os dados numéricos são atribuídos a variáveis sem modificação. A tabela a seguir ilustra como outros dados de entrada são tratados.

Dados	Valor atribuído à variável
Delimitar vírgula ou linha em branco	Vazio
#NULL#	`DBNull`
#TRUE# ou #FALSE#	`True` ou `False`
#`yyyy-mm-dd hh:mm:ss`#	A data e/ou hora representada pela expressão
#ERROR `errornumber`#	`errornumber` (variável é um objeto marcado como um erro)

Se você chegar ao final do arquivo enquanto estiver inserindo um item de dados, a entrada será interrompida e ocorrerá um erro.

Observação

Importante

A leitura de um arquivo usando a Input função requer Read acesso da FileIOPermissionAccess enumeração. Para obter mais informações, consulte FileIOPermissionAccess.

Confira também

Aplica-se a

Input(Int32, Int32)

Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.

public:
 static void Input(int FileNumber, int % Value);

public static void Input(int FileNumber, ref int Value);

static member Input : int * int -> unit

Public Sub Input (FileNumber As Integer, ByRef Value As Integer)

Parâmetros

FileNumber: Int32

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

Value: Int32

Required. Variável atribuída aos valores lidos do arquivo – não pode ser uma matriz ou variável de objeto.

Exceções

IOException

O modo de arquivo é inválido.

Exemplos

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)

Comentários

Os dados lidos geralmente Input são gravados em um arquivo usando Write. Use essa função somente com arquivos abertos no modo ou Binary no Input modo.

Importante

Quando lido, a cadeia padrão ou os dados numéricos são atribuídos a variáveis sem modificação. A tabela a seguir ilustra como outros dados de entrada são tratados.

Dados	Valor atribuído à variável
Delimitar vírgula ou linha em branco	Vazio
#NULL#	`DBNull`
#TRUE# ou #FALSE#	`True` ou `False`
#`yyyy-mm-dd hh:mm:ss`#	A data e/ou hora representada pela expressão
#ERROR `errornumber`#	`errornumber` (variável é um objeto marcado como um erro)

Se você chegar ao final do arquivo enquanto estiver inserindo um item de dados, a entrada será interrompida e ocorrerá um erro.

Observação

A Input função não está localizada. Por exemplo, na versão alemã, se você inserir 3.14159, ela retornará apenas 3, já que a vírgula é tratada como um separador de variável em vez de como um ponto decimal.

Importante

A leitura de um arquivo usando a Input função requer Read acesso da FileIOPermissionAccess enumeração. Para obter mais informações, consulte FileIOPermissionAccess.

Confira também

Aplica-se a

Input(Int32, Int16)

Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.

public:
 static void Input(int FileNumber, short % Value);

public static void Input(int FileNumber, ref short Value);

static member Input : int * int16 -> unit

Public Sub Input (FileNumber As Integer, ByRef Value As Short)

Parâmetros

FileNumber: Int32

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

Value: Int16

Required. Variável atribuída aos valores lidos do arquivo – não pode ser uma matriz ou variável de objeto.

Exceções

IOException

O modo de arquivo é inválido.

Exemplos

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)

Comentários

Os dados lidos geralmente Input são gravados em um arquivo usando Write. Use essa função somente com arquivos abertos no modo ou Binary no Input modo.

Importante

Quando lido, a cadeia padrão ou os dados numéricos são atribuídos a variáveis sem modificação. A tabela a seguir ilustra como outros dados de entrada são tratados.

Dados	Valor atribuído à variável
Delimitar vírgula ou linha em branco	Vazio
#NULL#	`DBNull`
#TRUE# ou #FALSE#	`True` ou `False`
#`yyyy-mm-dd hh:mm:ss`#	A data e/ou hora representada pela expressão
#ERROR `errornumber`#	`errornumber` (variável é um objeto marcado como um erro)

Se você chegar ao final do arquivo enquanto estiver inserindo um item de dados, a entrada será interrompida e ocorrerá um erro.

Observação

Importante

A leitura de um arquivo usando a Input função requer Read acesso da FileIOPermissionAccess enumeração. Para obter mais informações, consulte FileIOPermissionAccess.

Confira também

Aplica-se a

Input(Int32, Double)

Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.

public:
 static void Input(int FileNumber, double % Value);

public static void Input(int FileNumber, ref double Value);

static member Input : int * double -> unit

Public Sub Input (FileNumber As Integer, ByRef Value As Double)

Parâmetros

FileNumber: Int32

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

Value: Double

Required. Variável atribuída aos valores lidos do arquivo – não pode ser uma matriz ou variável de objeto.

Exceções

IOException

O modo de arquivo é inválido.

Exemplos

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)

Comentários

Os dados lidos geralmente Input são gravados em um arquivo usando Write. Use essa função somente com arquivos abertos no modo ou Binary no Input modo.

Importante

Quando lido, a cadeia padrão ou os dados numéricos são atribuídos a variáveis sem modificação. A tabela a seguir ilustra como outros dados de entrada são tratados.

Dados	Valor atribuído à variável
Delimitar vírgula ou linha em branco	Vazio
#NULL#	`DBNull`
#TRUE# ou #FALSE#	`True` ou `False`
#`yyyy-mm-dd hh:mm:ss`#	A data e/ou hora representada pela expressão
#ERROR `errornumber`#	`errornumber` (variável é um objeto marcado como um erro)

Se você chegar ao final do arquivo enquanto estiver inserindo um item de dados, a entrada será interrompida e ocorrerá um erro.

Observação

Importante

A leitura de um arquivo usando a Input função requer Read acesso da FileIOPermissionAccess enumeração. Para obter mais informações, consulte FileIOPermissionAccess.

Confira também

Aplica-se a

Input(Int32, Boolean)

Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.

public:
 static void Input(int FileNumber, bool % Value);

public static void Input(int FileNumber, ref bool Value);

static member Input : int * bool -> unit

Public Sub Input (FileNumber As Integer, ByRef Value As Boolean)

Parâmetros

FileNumber: Int32

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

Value: Boolean

Required. Variável atribuída aos valores lidos do arquivo – não pode ser uma matriz ou variável de objeto.

Exceções

IOException

O modo de arquivo é inválido.

Exemplos

Este exemplo usa a Input função para ler dados de um arquivo em duas variáveis. Este exemplo pressupõe que TestFile seja um arquivo que tenha algumas linhas de dados gravadas nela usando a Write função, cada linha contendo uma cadeia de caracteres entre aspas e um número separado por uma vírgula, por exemplo: ("Olá", 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)

Comentários

Os dados lidos geralmente Input são gravados em um arquivo usando Write. Use essa função somente com arquivos abertos no modo ou Binary no Input modo.

Importante

Quando lido, a cadeia padrão ou os dados numéricos são atribuídos a variáveis sem modificação. A tabela a seguir ilustra como outros dados de entrada são tratados.

Dados	Valor atribuído à variável
Delimitar vírgula ou linha em branco	Vazio
#NULL#	`DBNull`
#TRUE# ou #FALSE#	`True` ou `False`
#`yyyy-mm-dd hh:mm:ss`#	A data e/ou hora representada pela expressão
#ERROR `errornumber`#	`errornumber` (variável é um objeto marcado como um erro)

Se você chegar ao final do arquivo enquanto estiver inserindo um item de dados, a entrada será interrompida e ocorrerá um erro.

Observação

Importante

A leitura de um arquivo usando a Input função requer Read acesso da FileIOPermissionAccess enumeração. Para obter mais informações, consulte FileIOPermissionAccess.

Confira também

Aplica-se a

Input(Int32, DateTime)

Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.

public:
 static void Input(int FileNumber, DateTime % Value);

public static void Input(int FileNumber, ref DateTime Value);

static member Input : int * DateTime -> unit

Public Sub Input (FileNumber As Integer, ByRef Value As DateTime)

Parâmetros

FileNumber: Int32

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

Value: DateTime

Required. Variável atribuída aos valores lidos do arquivo – não pode ser uma matriz ou variável de objeto.

Exceções

IOException

O modo de arquivo é inválido.

Exemplos

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)

Comentários

Os dados lidos geralmente Input são gravados em um arquivo usando Write. Use essa função somente com arquivos abertos no modo ou Binary no Input modo.

Importante

Quando lido, a cadeia padrão ou os dados numéricos são atribuídos a variáveis sem modificação. A tabela a seguir ilustra como outros dados de entrada são tratados.

Dados	Valor atribuído à variável
Delimitar vírgula ou linha em branco	Vazio
#NULL#	`DBNull`
#TRUE# ou #FALSE#	`True` ou `False`
#`yyyy-mm-dd hh:mm:ss`#	A data e/ou hora representada pela expressão
#ERROR `errornumber`#	`errornumber` (variável é um objeto marcado como um erro)

Se você chegar ao final do arquivo enquanto estiver inserindo um item de dados, a entrada será interrompida e ocorrerá um erro.

Observação

Importante

A leitura de um arquivo usando a Input função requer Read acesso da FileIOPermissionAccess enumeração. Para obter mais informações, consulte FileIOPermissionAccess.

Confira também

Aplica-se a

Input(Int32, Char)

Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.

public:
 static void Input(int FileNumber, char % Value);

public static void Input(int FileNumber, ref char Value);

static member Input : int * char -> unit

Public Sub Input (FileNumber As Integer, ByRef Value As Char)

Parâmetros

FileNumber: Int32

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

Value: Char

Required. Variável atribuída aos valores lidos do arquivo – não pode ser uma matriz ou variável de objeto.

Exceções

IOException

O modo de arquivo é inválido.

Exemplos

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)

Comentários

Os dados lidos geralmente Input são gravados em um arquivo usando Write. Use essa função somente com arquivos abertos no modo ou Binary no Input modo.

Importante

Quando lido, a cadeia padrão ou os dados numéricos são atribuídos a variáveis sem modificação. A tabela a seguir ilustra como outros dados de entrada são tratados.

Dados	Valor atribuído à variável
Delimitar vírgula ou linha em branco	Vazio
#NULL#	`DBNull`
#TRUE# ou #FALSE#	`True` ou `False`
#`yyyy-mm-dd hh:mm:ss`#	A data e/ou hora representada pela expressão
#ERROR `errornumber`#	`errornumber` (variável é um objeto marcado como um erro)

Se você chegar ao final do arquivo enquanto estiver inserindo um item de dados, a entrada será interrompida e ocorrerá um erro.

Observação

Importante

A leitura de um arquivo usando a Input função requer Read acesso da FileIOPermissionAccess enumeração. Para obter mais informações, consulte FileIOPermissionAccess.

Confira também

Aplica-se a

Input(Int32, Byte)

Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.

public:
 static void Input(int FileNumber, System::Byte % Value);

public static void Input(int FileNumber, ref byte Value);

static member Input : int * byte -> unit

Public Sub Input (FileNumber As Integer, ByRef Value As Byte)

Parâmetros

FileNumber: Int32

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

Value: Byte

Required. Variável atribuída aos valores lidos do arquivo – não pode ser uma matriz ou variável de objeto.

Exceções

IOException

O modo de arquivo é inválido.

Exemplos

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)

Comentários

Os dados lidos geralmente Input são gravados em um arquivo usando Write. Use essa função somente com arquivos abertos no modo ou Binary no Input modo.

Importante

Quando lido, a cadeia padrão ou os dados numéricos são atribuídos a variáveis sem modificação. A tabela a seguir ilustra como outros dados de entrada são tratados.

Dados	Valor atribuído à variável
Delimitar vírgula ou linha em branco	Vazio
#NULL#	`DBNull`
#TRUE# ou #FALSE#	`True` ou `False`
#`yyyy-mm-dd hh:mm:ss`#	A data e/ou hora representada pela expressão
#ERROR `errornumber`#	`errornumber` (variável é um objeto marcado como um erro)

Se você chegar ao final do arquivo enquanto estiver inserindo um item de dados, a entrada será interrompida e ocorrerá um erro.

Observação

Importante

A leitura de um arquivo usando a Input função requer Read acesso da FileIOPermissionAccess enumeração. Para obter mais informações, consulte FileIOPermissionAccess.

Confira também

Aplica-se a

Input(Int32, Single)

Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.

public:
 static void Input(int FileNumber, float % Value);

public static void Input(int FileNumber, ref float Value);

static member Input : int * single -> unit

Public Sub Input (FileNumber As Integer, ByRef Value As Single)

Parâmetros

FileNumber: Int32

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

Value: Single

Required. Variável atribuída aos valores lidos do arquivo – não pode ser uma matriz ou variável de objeto.

Exceções

IOException

O modo de arquivo é inválido.

Exemplos

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)

Comentários

Os dados lidos geralmente Input são gravados em um arquivo usando Write. Use essa função somente com arquivos abertos no modo ou Binary no Input modo.

Importante

Quando lido, a cadeia padrão ou os dados numéricos são atribuídos a variáveis sem modificação. A tabela a seguir ilustra como outros dados de entrada são tratados.

Dados	Valor atribuído à variável
Delimitar vírgula ou linha em branco	Vazio
#NULL#	`DBNull`
#TRUE# ou #FALSE#	`True` ou `False`
#`yyyy-mm-dd hh:mm:ss`#	A data e/ou hora representada pela expressão
#ERROR `errornumber`#	`errornumber` (variável é um objeto marcado como um erro)

Se você chegar ao final do arquivo enquanto estiver inserindo um item de dados, a entrada será interrompida e ocorrerá um erro.

Observação

Importante

A leitura de um arquivo usando a Input função requer Read acesso da FileIOPermissionAccess enumeração. Para obter mais informações, consulte FileIOPermissionAccess.

Confira também

Aplica-se a

Input(Int32, Decimal)

Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.

public:
 static void Input(int FileNumber, System::Decimal % Value);

public static void Input(int FileNumber, ref decimal Value);

static member Input : int * decimal -> unit

Public Sub Input (FileNumber As Integer, ByRef Value As Decimal)

Parâmetros

FileNumber: Int32

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

Value: Decimal

Required. Variável atribuída aos valores lidos do arquivo – não pode ser uma matriz ou variável de objeto.

Exceções

IOException

O modo de arquivo é inválido.

Exemplos

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)

Comentários

Os dados lidos geralmente Input são gravados em um arquivo usando Write. Use essa função somente com arquivos abertos no modo ou Binary no Input modo.

Importante

Quando lido, a cadeia padrão ou os dados numéricos são atribuídos a variáveis sem modificação. A tabela a seguir ilustra como outros dados de entrada são tratados.

Dados	Valor atribuído à variável
Delimitar vírgula ou linha em branco	Vazio
#NULL#	`DBNull`
#TRUE# ou #FALSE#	`True` ou `False`
#`yyyy-mm-dd hh:mm:ss`#	A data e/ou hora representada pela expressão
#ERROR `errornumber`#	`errornumber` (variável é um objeto marcado como um erro)

Se você chegar ao final do arquivo enquanto estiver inserindo um item de dados, a entrada será interrompida e ocorrerá um erro.

Observação

Importante

A leitura de um arquivo usando a Input função requer Read acesso da FileIOPermissionAccess enumeração. Para obter mais informações, consulte FileIOPermissionAccess.

Confira também

Aplica-se a

Input(Int32, String)

Lê dados de um arquivo sequencial aberto e atribui os dados a variáveis.

public:
 static void Input(int FileNumber, System::String ^ % Value);

public static void Input(int FileNumber, ref string Value);

static member Input : int * string -> unit

Public Sub Input (FileNumber As Integer, ByRef Value As String)

Parâmetros

FileNumber: Int32

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

Value: String

Required. Variável atribuída aos valores lidos do arquivo – não pode ser uma matriz ou variável de objeto.

Exceções

IOException

O modo de arquivo é inválido.

Exemplos

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)

Comentários

Os dados lidos geralmente Input são gravados em um arquivo usando Write. Use essa função somente com arquivos abertos no modo ou Binary no Input modo.

Importante

Quando lido, a cadeia padrão ou os dados numéricos são atribuídos a variáveis sem modificação. A tabela a seguir ilustra como outros dados de entrada são tratados.

Dados	Valor atribuído à variável
Delimitar vírgula ou linha em branco	Vazio
#NULL#	`DBNull`
#TRUE# ou #FALSE#	`True` ou `False`
#`yyyy-mm-dd hh:mm:ss`#	A data e/ou hora representada pela expressão
#ERROR `errornumber`#	`errornumber` (variável é um objeto marcado como um erro)

Se você chegar ao final do arquivo enquanto estiver inserindo um item de dados, a entrada será interrompida e ocorrerá um erro.

Observação

Importante

A leitura de um arquivo usando a Input função requer Read acesso da FileIOPermissionAccess enumeração. Para obter mais informações, consulte FileIOPermissionAccess.

Confira também

Aplica-se a

Comentários

Esta página foi útil?