Compartilhar via


TextFieldParser Classe

Definição

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
TextFieldParser
Implementações

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

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

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

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)

Implantações explícitas de interface

IDisposable.Dispose()

Libera recursos usados pelo objeto TextFieldParser.

Aplica-se a

Confira também