TextFieldParser.ReadFields Método

Definição

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

TextFieldParser.vb

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 contendo 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 os 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írgulas . O exemplo grava os campos Testfile.txtem .

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 forem especificados, sempre que forem chamados. Os usuários precisam configurar corretamente as TextFieldType propriedades e FieldWidths ou Delimiters , conforme apropriado. Se TextFieldType for definido Delimitedcomo , e Delimiters não estiver definido ou se TextFieldType estiver definido como FixedWidth e FieldWidths, 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	Consulte
Ler de um arquivo delimitado	Como: ler de arquivos de texto separados por vírgula
Ler de um arquivo de largura fixa	Como: ler de arquivos de texto de largura fixa

Confira também

• OpenTextFieldParser(String)
• TextFieldType
• FieldWidths
• Delimiters
• ReadLine()
• Objetos (Visual Basic)
• Como ler de um arquivo de texto Comma-Delimited no Visual Basic
• Como ler de um arquivo de texto de largura fixa no Visual Basic
• Como ler de um arquivo de texto com vários formatos no Visual Basic
• Analisando arquivos de texto com o objeto TextFieldParser