Sdílet prostřednictvím


TextFieldParser Třída

Definice

Poskytuje metody a vlastnosti pro parsování 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
TextFieldParser
Implementuje

Příklady

Tento příklad analyzuje textový soubor Bigfileoddělený tabulátory .

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 pomocí TextFieldParser je podobná iteraci v textovém souboru, zatímco použití ReadFields metody extrahování textových polí se podobá rozdělení řetězců.

Může TextFieldParser analyzovat dva typy souborů: soubory s oddělovači nebo s pevnou šířkou. Některé vlastnosti, například Delimiters a HasFieldsEnclosedInQuotes , mají smysl 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 úloh zahrnujících Microsoft.VisualBasic.FileIO.TextFieldParser objekt .

Záměr Seznamte se s 
Čtení z textového souboru s oddělovači Postupy: Čtení z textových souborů s oddělovačem čárkou
Č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ů ve více formátech

Konstruktory

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

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 analyzátor by ho měl ignorovat.

Delimiters

Definuje oddělovače textového souboru.

EndOfData

Vrátí hodnotu True , pokud mezi aktuální pozicí kurzoru a koncem souboru nejsou žádné neprázdné řádky bez komentáře.

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 analyzovaného textovém souboru.

HasFieldsEnclosedInQuotes

Označuje, zda jsou pole uzavřena v uvozovkách při analýze souboru s oddělovači.

LineNumber

Vrátí číslo aktuálního řádku nebo vrátí hodnotu -1, pokud v datovém proudu nejsou k dispozici žádné další znaky.

TextFieldType

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

TrimWhiteSpace

Určuje, zda mají být počáteční a koncové prázdné znaky oříznuty z hodnot polí.

Metody

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

Umožňuje objektu TextFieldParser pokusit se uvolnit prostředky a provádět další operace čištění předtím, než je uvolněna uvolňováním paměti.

GetHashCode()

Slouží jako výchozí hashovací funkce.

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

Type Získá z aktuální instance.

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

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

(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 posune kurzor na další řádek obsahující data.

ReadLine()

Vrátí aktuální řádek jako řetězec a posune 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 čtečku na zadané hodnoty.

ToString()

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

(Zděděno od Object)

Explicitní implementace rozhraní

IDisposable.Dispose()

Uvolní prostředky používané objektem TextFieldParser .

Platí pro

Viz také