FileSystem.InputString(Int32, Int32) Método

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

FileSystem.vb

Retorna o valor String que contém caracteres de um arquivo aberto no modo Input ou Binary. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que InputString. Para obter mais informações, consulte FileSystem.

public:
 static System::String ^ InputString(int FileNumber, int CharCount);

[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("macos")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public static string InputString (int FileNumber, int CharCount);

[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("macos")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
static member InputString : int * int -> string

Public Function InputString (FileNumber As Integer, CharCount As Integer) As String

Parâmetros

FileNumber

Int32

Obrigatórios. Qualquer número de arquivo válido.

CharCount

Int32

Obrigatórios. Qualquer expressão numérica válida que especifica o número de caracteres a serem lidos.

Retornos

String

Uma cadeia de caracteres que contém caracteres de um arquivo aberto no modo Input ou Binary. O recurso My oferece melhor produtividade e desempenho em operações de E/S do arquivo do que InputString.

Atributos

UnsupportedOSPlatformAttribute

Exceções

IOException

FileNumber não existe.

ArgumentException

CharCount< 0 ou > 214.

Exemplos

Este exemplo usa a InputString função para ler um caractere de cada vez de um arquivo e imprimi-lo na Output janela. Este exemplo pressupõe que MyFile é um arquivo de texto que tem várias linhas de dados de exemplo.

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)

Comentários

A InputString 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 saber mais informações, confira Acesso a Arquivos com o Visual Basic.

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

Ao contrário da Input função , a InputString função retorna todos os caracteres que lê. Isso inclui vírgulas, retornos de carro, alimentações de linha, aspas e espaços à esquerda.

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

Observação

Ao ler de arquivos, não tome decisões de segurança 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 do Visual Basic.

Confira também

• Input
• Access de arquivo com o Visual Basic
• Como gravar texto em um arquivo com um Streamwriter (Visual Basic)
• Como gravar texto em arquivos no Visual Basic