TextFieldParser Classe

Referência

Definição

Namespace:: Microsoft.VisualBasic.FileIO

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Origem:: TextFieldParser.vb

Origem:: TextFieldParser.vb

Origem:: TextFieldParser.vb

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

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

Partilhar via