TextFieldParser.ReadFields Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Lê todos os campos da linha atual, devolve-os como um array de cadeias e avança o cursor para a linha seguinte contendo dados.
public:
cli::array <System::String ^> ^ ReadFields();
public string[] ReadFields();
member this.ReadFields : unit -> string[]
Public Function ReadFields () As String()
Devoluções
Um array de cadeias que contém 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 a partir do ficheiro ParserText.txtdelimitado por vírgulas . O exemplo escreve os corpos 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
Observações
Para permitir que os utilizadores analisem ficheiros de texto em múltiplos formatos, o ReadFields método examina os valores de TextFieldType, Delimiters, e FieldWidths, se forem especificados, cada vez que é chamado. Os utilizadores precisam de configurar corretamente as TextFieldType propriedades e FieldWidths / Delimiters /, conforme apropriado. Se TextFieldType for definido como Delimited, e Delimiters não for definido, ou se TextFieldType for definido como FixedWidth e FieldWidths não for definido, é lançada uma exceção.
Se ReadFields encontrar linhas em branco, elas são ignoradas e a próxima linha não em branco é devolvida.
Se o ReadFields método não conseguir analisar a linha atual, levanta uma exceção e não passa para a linha seguinte. Isto permite que a sua aplicação tente analisar a linha novamente.
A tabela seguinte lista exemplos de tarefas que envolvem o ReadFields método.
| Para | Veja |
|---|---|
| Lido a partir de um ficheiro delimitado | Como Ler Arquivos de Texto Comma-Delimited |
| Lido a partir de um ficheiro de largura fixa | Como: Ler a partir de arquivos de texto de largura fixa |
Aplica-se a
Ver também
- OpenTextFieldParser(String)
- TextFieldType
- FieldWidths
- Delimiters
- ReadLine()
- Objects (Visual Basic)
- Como: ler de um ficheiro de texto Comma-Delimited em Visual Basic
- Como: ler de um ficheiro de texto de largura fixa em Visual Basic
- Como: ler de um ficheiro de texto com múltiplos formatos em Visual Basic
- Analisando arquivos de texto com o objeto TextFieldParser