TextFieldParser Třída

Definice

Obor názvů:
Microsoft.VisualBasic.FileIO
Sestavení:
Microsoft.VisualBasic.dll

Poskytuje metody a vlastnosti pro analýzu strukturovaných textových souborů.

public ref class TextFieldParser : IDisposable
public class TextFieldParser : IDisposable
type TextFieldParser = class
    interface IDisposable
Public Class TextFieldParser
Implements IDisposable
Dědičnost
Object
TextFieldParser
Implementuje
IDisposable

Příklady

Tento příklad analyzuje textový soubor oddělený tabulátorem . 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

Poznámky

Objekt TextFieldParser poskytuje metody a vlastnosti pro analýzu strukturovaných textových souborů. Analýza textového souboru s textovým souborem TextFieldParser se podobá iteraci textového souboru, zatímco použití ReadFields metody extrakce polí textu je podobné rozdělení řetězců.

Může TextFieldParser analyzovat dva typy souborů: oddělené nebo s pevnou šířkou. Některé vlastnosti, například Delimiters a HasFieldsEnclosedInQuotes jsou smysluplné pouze při práci se soubory s oddělovači, zatímco FieldWidths vlastnost je smysluplná pouze při práci se soubory s pevnou šířkou.

Následující tabulka uvádí příklady úkolů zahrnujících objekt Microsoft.VisualBasic.FileIO.TextFieldParser.

To Podívejte se
Čtení z textového souboru s oddělovači Jak číst z Comma-Delimited textových souborů
Čtení z textového souboru s pevnou šířkou Postupy: Čtení z textových souborů s pevnou šířkou
Čtení z textového souboru s více formáty Postupy: Čtení z textových souborů s více formáty

Konstruktory

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

Inicializuje novou instanci TextFieldParser třídy.
TextFieldParser(Stream, Encoding, Boolean)

Inicializuje novou instanci TextFieldParser třídy.
TextFieldParser(Stream, Encoding)

Inicializuje novou instanci TextFieldParser třídy.
TextFieldParser(Stream)

Inicializuje novou instanci TextFieldParser třídy.
TextFieldParser(String, Encoding, Boolean)

Inicializuje novou instanci TextFieldParser třídy.
TextFieldParser(String, Encoding)

Inicializuje novou instanci TextFieldParser třídy.
TextFieldParser(String)

Inicializuje novou instanci TextFieldParser třídy.
TextFieldParser(TextReader)

Inicializuje novou instanci TextFieldParser třídy.

Vlastnosti

Name Description
CommentTokens

Definuje tokeny komentářů. Token komentáře je řetězec, který při umístění na začátek řádku označuje, že řádek je komentář a měl by být ignorován analyzátorem.
Delimiters

Definuje oddělovače textového souboru.
EndOfData

Vrátí True , pokud neexistují žádné neprázdné řádky bez komentáře mezi aktuálním umístěním kurzoru a koncem souboru.
ErrorLine

Vrátí řádek, který způsobil poslední MalformedLineException výjimku.
ErrorLineNumber

Vrátí číslo řádku, který způsobil poslední MalformedLineException výjimku.
FieldWidths

Označuje šířku každého sloupce v textovém souboru, který se analyzuje.
HasFieldsEnclosedInQuotes

Označuje, zda jsou pole uzavřena do uvozovek při analýze souboru s oddělovači.
LineNumber

Vrátí číslo aktuálního řádku nebo vrátí -1, pokud ve streamu nejsou k dispozici žádné další znaky.
TextFieldType

Určuje, zda je soubor, který se má analyzovat, oddělený nebo s pevnou šířkou.
TrimWhiteSpace

Určuje, jestli by se počáteční a koncové prázdné znaky měly oříznout z hodnot polí.

Metody

Name Description
Close()

Zavře aktuální TextFieldParser objekt.
Dispose()

Uvolní prostředky používané objektem TextFieldParser .
Dispose(Boolean)

Uvolní prostředky používané objektem TextFieldParser .
Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
Finalize()

TextFieldParser Umožňuje objektu pokusit se uvolnit prostředky a provést další operace čištění před uvolněním paměti.
GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetType()

Získá Type aktuální instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Object.

(Zděděno od Object)
PeekChars(Int32)

Přečte zadaný počet znaků bez posunu kurzoru.
ReadFields()

Přečte všechna pole na aktuálním řádku, vrátí je jako pole řetězců a přejde kurzor na další řádek obsahující data.
ReadLine()

Vrátí aktuální řádek jako řetězec a přejde kurzor na další řádek.
ReadToEnd()

Přečte zbytek textového souboru a vrátí ho jako řetězec.
SetDelimiters(String[])

Nastaví oddělovače pro čtenáře na zadané hodnoty a nastaví typ pole na Delimited.
SetFieldWidths(Int32[])

Nastaví oddělovače pro čtenáře na zadané hodnoty.
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Platí pro

Viz také