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 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)	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í řá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

Sdílet prostřednictvím