TextFieldParser Osztály

Definíció

Metódusokat és tulajdonságokat biztosít a strukturált szövegfájlok elemzéséhez.

public ref class TextFieldParser : IDisposable
public class TextFieldParser : IDisposable
type TextFieldParser = class
    interface IDisposable
Public Class TextFieldParser
Implements IDisposable
Öröklődés
TextFieldParser
Megvalósítás

Példák

Ez a példa egy tabulátorral tagolt szövegfájlon keresztül elemez. 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

Megjegyzések

Az TextFieldParser objektum metódusokat és tulajdonságokat biztosít a strukturált szövegfájlok elemzéséhez. A szövegfájl TextFieldParser elemzése hasonló a szövegfájlon végzett iteráláshoz, míg a ReadFields szövegmezők kinyerésének módszere hasonló a sztringek felosztásához.

Két TextFieldParser fájltípust elemezhet: tagolt vagy rögzített szélességű. Egyes tulajdonságok, például DelimitersHasFieldsEnclosedInQuotes csak a tagolt fájlok használata esetén értelmezhetők, míg a FieldWidths tulajdonság csak rögzített szélességű fájlok használatakor értelmezhető.

Az alábbi táblázat példákat sorol fel az Microsoft.VisualBasic.FileIO.TextFieldParser objektumot érintő tevékenységekre.

Címzett Nézze
Olvasás tagolt szövegfájlból Útmutató: Olvasás Comma-Delimited szövegfájlokból
Olvasás rögzített szélességű szövegfájlból Útmutató: Olvasás rögzített szélességű szövegfájlokból
Olvasás több formátumot tartalmazó szövegfájlból Útmutató: Olvasás több formátumot tartalmazó szövegfájlokból

Konstruktorok

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

Inicializálja a TextFieldParser osztály új példányát.

TextFieldParser(Stream, Encoding, Boolean)

Inicializálja a TextFieldParser osztály új példányát.

TextFieldParser(Stream, Encoding)

Inicializálja a TextFieldParser osztály új példányát.

TextFieldParser(Stream)

Inicializálja a TextFieldParser osztály új példányát.

TextFieldParser(String, Encoding, Boolean)

Inicializálja a TextFieldParser osztály új példányát.

TextFieldParser(String, Encoding)

Inicializálja a TextFieldParser osztály új példányát.

TextFieldParser(String)

Inicializálja a TextFieldParser osztály új példányát.

TextFieldParser(TextReader)

Inicializálja a TextFieldParser osztály új példányát.

Tulajdonságok

Name Description
CommentTokens

Megjegyzés jogkivonatokat határoz meg. A megjegyzés jogkivonata egy olyan sztring, amely egy sor elején elhelyezve azt jelzi, hogy a sor megjegyzés, és az elemzőnek figyelmen kívül kell hagynia.

Delimiters

Meghatározza egy szövegfájl elválasztóit.

EndOfData

Akkor adja True vissza, ha az aktuális kurzor pozíciója és a fájl vége között nincsenek nem üres, megjegyzés nélküli sorok.

ErrorLine

A legutóbbi MalformedLineException kivételt okozó sort adja vissza.

ErrorLineNumber

A legutóbbi MalformedLineException kivételt okozó sor számát adja vissza.

FieldWidths

Az elemzett szövegfájl egyes oszlopainak szélességét jelöli.

HasFieldsEnclosedInQuotes

Azt jelzi, hogy a mezők idézőjelek közé vannak-e zárva egy tagolt fájl elemzésekor.

LineNumber

Az aktuális sor számát adja vissza, vagy -1 ad vissza, ha nincs több karakter a streamben.

TextFieldType

Azt jelzi, hogy az elemezni kívánt fájl el van-e tagolt vagy rögzített szélességű.

TrimWhiteSpace

Azt jelzi, hogy a kezdő és a záró szóközt levágni kell-e a mezőértékekből.

Metódusok

Name Description
Close()

Bezárja az aktuális TextFieldParser objektumot.

Dispose()

Felszabadítja az TextFieldParser objektum által használt erőforrásokat.

Dispose(Boolean)

Felszabadítja az TextFieldParser objektum által használt erőforrásokat.

Equals(Object)

Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal.

(Öröklődés forrása Object)
Finalize()

Lehetővé teszi, hogy az TextFieldParser objektum megkísérlje felszabadítani az erőforrásokat, és más tisztítási műveleteket hajt végre, mielőtt a szemétgyűjtés visszanyeri azt.

GetHashCode()

Ez az alapértelmezett kivonatoló függvény.

(Öröklődés forrása Object)
GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
PeekChars(Int32)

Beolvassa a megadott számú karaktert a kurzor előrehaladása nélkül.

ReadFields()

Beolvassa az aktuális sor összes mezőjét, sztringtömbként adja vissza őket, és a kurzort az adatokat tartalmazó következő sorba viszi.

ReadLine()

Sztringként adja vissza az aktuális sort, és a kurzort a következő sorra viszi.

ReadToEnd()

Beolvassa a szövegfájl fennmaradó részét, és sztringként adja vissza.

SetDelimiters(String[])

Az olvasó elválasztóit a megadott értékekre állítja, és a mezőtípust a következőre Delimitedállítja: .

SetFieldWidths(Int32[])

Az olvasó elválasztóit a megadott értékekre állítja.

ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)

A következőre érvényes:

Lásd még