TextFieldParser Třída

Reference

Definice

Obor názvů:: Microsoft.VisualBasic.FileIO

Sestavení:: Microsoft.VisualBasic.Core.dll

Sestavení:: Microsoft.VisualBasic.dll

Zdroj:: TextFieldParser.vb

Zdroj:: TextFieldParser.vb

Zdroj:: TextFieldParser.vb

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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: Object
TextFieldParser

Implementuje: IDisposable

Příklady

Tento příklad parsuje textový soubor s oddělovači tabulátoru . 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ů. Parsování textového souboru pomocí TextFieldParser textového souboru se podobá iteraci textového souboru, zatímco použití ReadFields metody k extrakci polí textu je podobné 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 , 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.

V následující tabulce jsou uvedeny příklady úloh, které se týkají objektu Microsoft.VisualBasic.FileIO.TextFieldParser .

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)	Inicializuje novou instanci `TextFieldParser` třídy.
TextFieldParser(Stream, Encoding)	Inicializuje novou instanci `TextFieldParser` třídy.
TextFieldParser(Stream, Encoding, Boolean)	Inicializuje novou instanci `TextFieldParser` třídy.
TextFieldParser(Stream, Encoding, Boolean, Boolean)	Inicializuje novou instanci `TextFieldParser` třídy.
TextFieldParser(String)	Inicializuje novou instanci `TextFieldParser` třídy.
TextFieldParser(String, Encoding)	Inicializuje novou instanci `TextFieldParser` třídy.
TextFieldParser(String, Encoding, Boolean)	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í čáru, která způsobila poslední MalformedLineException výjimku.
ErrorLineNumber	Vrátí číslo řádku, který způsobil poslední MalformedLineException výjimku.
FieldWidths	Označuje šířku jednotlivých sloupců 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, jestli se mají počáteční a koncové prázdné znaky oříznout 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ést 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()	Získá aktuální Type instanci. (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 přesune kurzor na další řádek obsahující data.
ReadLine()	Vrátí aktuální řádek jako řetězec a přesune 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)

Explicitní implementace rozhraní

IDisposable.Dispose()

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

Platí pro