Método TextFieldParser.ReadFields

Lê todos os campos na linha atual, retorna-os como um vetor de cadeia de caracteres e avança o cursor para a próxima linha contendo dados.

' Usage
Dim value As String() = TextFieldParserObject.ReadFields()
' Declaration
Public Function ReadFields() As String()

Valor de retorno

String ().

Exceções

A seguinte condição pode fazer com que uma exceção seja lançada:

• Um campo não pode ser analisado usando o formato especificado (MalformedLineException).

Comentários

Para permitir aos usuários passar arquivos de texto em múltiplos formatos, o método ReadFields examina o valor de TextFieldType, Delimiters e FieldWidths, caso eles sejam especificados, cada vez que é chamado.Usuários precisam configurar corretamente as propriedades TextFieldType e FieldWidths ou Delimiters, como apropriado.Se TextFieldType é definido como Delimited e Delimiters não é definido, ou se TextFieldType é definido como FixedWidth e FieldWidths não é definido, uma exceção é lançada.

Se ReadFields encontra linhas em branco, elas são ignoradas e a próxima linha não vazia é retornada.

Observação:
Se o ReadFields método não é possível analisar a linha corrente, ele gerará uma exceção e não move para a próxima linha. Isto permite que seu aplicativo tente analisar a linha novamente.

Tarefas

A tabela a seguir lista exemplos de tarefas envolvendo o método ReadFields.

Para	Consulte
Ler de um arquivo delimitado	Como: Leitura de arquivos de texto delimitado por vírgulas no Visual Basic
Ler de um arquivo de largura fixa	Como: Leitura de Fixo-largura arquivos de texto no Visual Basic

Exemplo

Este exemplo usa o método ReadFields para ler do arquivo ParserText.txt e escrever os campos em Testfile.txt.

Using MyReader As New Microsoft.VisualBasic.FileIO.TextFieldParser("C:\ParserText.txt")
    MyReader.TextFieldType = Microsoft.VisualBasic.FileIO.FieldType.Delimited
    MyReader.Delimiters = New String() {","}
    Dim currentRow As String()
    While Not MyReader.EndOfData
        Try
            currentRow = MyReader.ReadFields()
            For Each currentField As String In currentRow
                My.Computer.FileSystem.WriteAllText _
                ("C://testfile.txt", currentField, True)
            Next
        Catch ex As Microsoft.VisualBasic.FileIO.MalformedLineException
            MsgBox("Line " & ex.Message & " is invalid.  Skipping")
        End Try
    End While
End Using

Requisitos

Namespace:Microsoft.VisualBasic.FileIO

Classe:TextFieldParser

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

Permissões

As seguintes permissões são necessárias:

Permissão	Descrição
FileIOPermission	Enumeração associada: Unrestricted.
SecurityPermission	Enumeração associada: ControlEvidence.

Para obter mais informações, consulte Segurança de Acesso de código e Solicitando permissões.

Consulte também

Tarefas

Como: Leitura de arquivos de texto delimitado por vírgulas no Visual Basic

Como: Leitura de Fixo-largura arquivos de texto no Visual Basic

Como: Leitura de arquivos de texto com Múltiplo formatos no Visual Basic

Conceitos

Analisar Arquivos de Texto com o Objeto TextFieldParser

Referência

TextFieldParser objeto

TextFieldParser.ReadFields

Propriedade TextFieldParser.TextFieldType

Propriedade TextFieldParser.FieldWidths

Propriedade TextFieldParser.Delimiters

Método TextFieldParser.ReadLine