TextFieldParser Classe

Definição

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

TextFieldParser.vb

Fornece métodos e propriedades para analisar arquivos de texto estruturado.

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 por meio de um arquivo 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

Comentários

O TextFieldParser objeto fornece métodos e propriedades para analisar arquivos de texto estruturados. A análise de um arquivo de texto com o TextFieldParser é semelhante à iteração em um arquivo de texto, enquanto o uso do ReadFields método para extrair campos de texto é semelhante à divisão das cadeias de caracteres.

O TextFieldParser pode analisar dois tipos de arquivos: delimitados ou de largura fixa. Algumas propriedades, como Delimiters e HasFieldsEnclosedInQuotes são significativas somente ao trabalhar com arquivos delimitados, enquanto a FieldWidths propriedade é significativa somente ao trabalhar com arquivos de largura fixa.

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

Para	Consulte
Ler de um arquivo de texto delimitado	Como: ler de arquivos de texto separados por vírgula
Ler de um arquivo de texto de largura fixa	Como: ler de arquivos de texto de largura fixa
Ler de um arquivo de texto com vários formatos	Como: ler de arquivos de texto com vários formatos

Construtores

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

Propriedades

Nome	Description
CommentTokens	Define tokens de comentário. Um token de comentário é uma cadeia de caracteres 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 arquivo de texto.
EndOfData	Retorna True se não houver linha que não está em branco ou linha não comentada entre a posição atual do cursor e o fim do arquivo.
ErrorLine	Retorna a linha que causou a mais recente exceção MalformedLineException.
ErrorLineNumber	Retorna o número da linha que causou a mais recente exceção MalformedLineException.
FieldWidths	Indica a largura de cada coluna no arquivo de texto que está sendo analisado.
HasFieldsEnclosedInQuotes	Indica se os campos serão colocados entre aspas quando um arquivo delimitado está sendo analisado.
LineNumber	Retorna o número de linha atual ou -1 se não houver mais nenhum caractere disponível no fluxo.
TextFieldType	Indica se o arquivo a ser analisado é delimitado ou com uma largura fixa.
TrimWhiteSpace	Indica se espaços em branco à esquerda e à direita devem ser removidos dos valores de campo.

Métodos

Nome	Description
Close()	Fecha o objeto TextFieldParser atual.
Dispose()	Libera recursos usados pelo objeto TextFieldParser.
Dispose(Boolean)	Libera recursos usados pelo objeto TextFieldParser.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Finalize()	Permite que o objeto TextFieldParser tente liberar recursos e realizar outras operações de limpeza antes que ela é recuperada pela coleta de lixo.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
PeekChars(Int32)	Lê o número especificado de caracteres sem avançar o cursor.
ReadFields()	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.
ReadLine()	Retorna a linha atual como uma cadeia de caracteres e avança o cursor para a próxima linha.
ReadToEnd()	Lê o restante do arquivo de texto e retorna-o como uma cadeia de caracteres.
SetDelimiters(String[])	Define os delimitadores do leitor para os valores especificados e define o tipo de campo como Delimited.
SetFieldWidths(Int32[])	Define os delimitadores do leitor para os valores especificados.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• OpenTextFieldParser(String)
• Objetos (Visual Basic)
• Analisando arquivos de texto com o objeto TextFieldParser
• Exceções de solução de problemas: Microsoft.VisualBasic.FileIO.TextFieldParser.MalformedLineException