TextFieldParser.ReadFields Método

Definição

Namespace:
Microsoft.VisualBasic.FileIO
Assembly:
Microsoft.VisualBasic.dll

Lê todos os campos na linha atual, retorna-os como uma matriz de cadeias de caracteres e avança o cursor para a próxima linha que contém dados.

public:
 cli::array <System::String ^> ^ ReadFields();
public string[] ReadFields();
member this.ReadFields : unit -> string[]
Public Function ReadFields () As String()

Retornos

String[]

Uma matriz de cadeias de caracteres que contém valores de campo para a linha atual.

Exceções

MalformedLineException

Um campo não pode ser analisado usando o formato especificado.

Exemplos

Este exemplo usa o ReadFields método para ler do arquivo ParserText.txtdelimitado por vírgula. O exemplo grava 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

Comentários

Para permitir que os usuários analisem arquivos de texto em vários formatos, o ReadFields método examina os valores de TextFieldType, Delimiterse FieldWidths, se eles forem especificados, cada vez que ele for chamado. Os usuários precisam configurar corretamente o e FieldWidths ou Delimiters as TextFieldType propriedades, conforme apropriado. Se TextFieldType estiver definido como Delimited, e Delimiters não estiver definido ou se TextFieldType estiver definido FixedWidth como e FieldWidths não estiver definido, uma exceção será gerada.

Se ReadFields encontrar linhas em branco, elas serão ignoradas e a próxima linha não em branco será retornada.

Se o ReadFields método não puder analisar a linha atual, ele gerará uma exceção e não moverá para a próxima linha. Isso permite que seu aplicativo tente analisar a linha novamente.

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

Para Veja
Ler de um arquivo delimitado Como ler a partir de arquivos de texto Comma-Delimited
Ler de um arquivo de largura fixa Como ler de arquivos de texto de largura fixa

Aplica-se a

Confira também