Compartilhar via


TextFieldParser.ReadFields Método

Definição

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 ();
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

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

Aplica-se a

Confira também