TextFieldParser Classe

Definição

Espaço de Nomes:
Microsoft.VisualBasic.FileIO
Assemblagem:
Microsoft.VisualBasic.dll

Fornece métodos e propriedades para análise de ficheiros de texto estruturados.

public ref class TextFieldParser : IDisposable
public class TextFieldParser : IDisposable
type TextFieldParser = class
    interface IDisposable
Public Class TextFieldParser
Implements IDisposable
Herança
Object
TextFieldParser
Implementações
IDisposable

Exemplos

Este exemplo analisa um ficheiro de texto delimitado por tabulação, Bigfile.

Using MyReader As New Microsoft.VisualBasic.FileIO.
    TextFieldParser("c:\logs\bigfile")

    MyReader.TextFieldType = 
        Microsoft.VisualBasic.FileIO.FieldType.Delimited
    MyReader.Delimiters = New String() {vbTab}
    Dim currentRow As String()
    'Loop through all of the fields in the file. 
    'If any lines are corrupt, report an error and continue parsing. 
    While Not MyReader.EndOfData
        Try
            currentRow = MyReader.ReadFields()
            ' Include code here to handle the row.
        Catch ex As Microsoft.VisualBasic.FileIO.MalformedLineException
            MsgBox("Line " & ex.Message & 
            " is invalid.  Skipping")
        End Try
    End While
End Using

Observações

O TextFieldParser objeto fornece métodos e propriedades para analisar ficheiros de texto estruturados. Analisar um ficheiro de texto com o TextFieldParser é semelhante a iterar sobre um ficheiro de texto, enquanto usar o ReadFields método para extrair campos de texto é semelhante a dividir as cadeias de caracteres.

Podem TextFieldParser analisar dois tipos de ficheiros: delimitados ou de largura fixa. Algumas propriedades, como Delimiters e HasFieldsEnclosedInQuotes são significativas apenas quando se trabalha com ficheiros delimitados, enquanto a FieldWidths propriedade é significativa apenas quando se trabalha com ficheiros de largura fixa.

A tabela seguinte lista exemplos de tarefas envolvendo o objeto Microsoft.VisualBasic.FileIO.TextFieldParser.

Para Veja
Lido a partir de um ficheiro de texto delimitado Como Ler Arquivos de Texto Comma-Delimited
Lido a partir de um ficheiro de texto de largura fixa Como: Ler a partir de arquivos de texto de largura fixa
Lido a partir de um ficheiro de texto com múltiplos formatos Como: Ler a partir de arquivos de texto com vários formatos

Construtores

Name Description
TextFieldParser(Stream, Encoding, Boolean, Boolean)

Inicializa uma nova instância da TextFieldParser classe.
TextFieldParser(Stream, Encoding, Boolean)

Inicializa uma nova instância da TextFieldParser classe.
TextFieldParser(Stream, Encoding)

Inicializa uma nova instância da TextFieldParser classe.
TextFieldParser(Stream)

Inicializa uma nova instância da TextFieldParser classe.
TextFieldParser(String, Encoding, Boolean)

Inicializa uma nova instância da TextFieldParser classe.
TextFieldParser(String, Encoding)

Inicializa uma nova instância da TextFieldParser classe.
TextFieldParser(String)

Inicializa uma nova instância da TextFieldParser classe.
TextFieldParser(TextReader)

Inicializa uma nova instância da TextFieldParser classe.

Propriedades

Name Description
CommentTokens

Define tokens de comentário. Um token de comentário é uma cadeia que, quando colocada no início de uma linha, indica que a linha é um comentário e deve ser ignorada pelo analisador.
Delimiters

Define os delimitadores para um ficheiro de texto.
EndOfData

Retorna True se não houver linhas não em branco ou sem comentário entre a posição atual do cursor e o final do ficheiro.
ErrorLine

Devolve a linha que causou a exceção mais recente MalformedLineException .
ErrorLineNumber

Devolve o número da linha que causou a exceção mais recente MalformedLineException .
FieldWidths

Denota a largura de cada coluna no ficheiro de texto a analisar.
HasFieldsEnclosedInQuotes

Indica se os campos estão incluídos entre aspas quando um ficheiro delimitado está a ser analisado.
LineNumber

Devolve o número da linha atual, ou devolve -1 se não houver mais caracteres disponíveis no stream.
TextFieldType

Indica se o ficheiro a analisar é delimitado ou de largura fixa.
TrimWhiteSpace

Indica se o espaço em branco inicial e final deve ser cortado dos valores dos campos.

Métodos

Name Description
Close()

Fecha o objeto atual TextFieldParser .
Dispose()

Liberta os recursos usados pelo TextFieldParser objeto.
Dispose(Boolean)

Liberta os recursos usados pelo TextFieldParser objeto.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Finalize()

Permite que o TextFieldParser objeto tente libertar recursos e realizar outras operações de limpeza antes de ser recuperado pela recolha de lixo.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
PeekChars(Int32)

Lê o número especificado de caracteres sem avançar o cursor.
ReadFields()

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.
ReadLine()

Retorna a linha atual como uma cadeia e avança o cursor para a linha seguinte.
ReadToEnd()

Lê o restante do ficheiro de texto e devolve-o como uma cadeia.
SetDelimiters(String[])

Define os delimitadores do leitor para os valores especificados e define o tipo de campo para Delimited.
SetFieldWidths(Int32[])

Define os delimitadores para o leitor aos valores especificados.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também