Freigeben über


TextFieldParser Klasse

Definition

Stellt Methoden und Eigenschaften zur Analyse strukturierter Textdateien bereit.

public ref class TextFieldParser : IDisposable
public class TextFieldParser : IDisposable
type TextFieldParser = class
    interface IDisposable
Public Class TextFieldParser
Implements IDisposable
Vererbung
TextFieldParser
Implementiert

Beispiele

In diesem Beispiel wird die Textdatei analysiert, die durch Tabstopps getrennt ist. 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

Hinweise

Das TextFieldParser -Objekt stellt Methoden und Eigenschaften zum Analysieren strukturierter Textdateien bereit. Das Analysieren einer Textdatei mit dem ähnelt dem TextFieldParser Durchlaufen einer Textdatei, während die Verwendung der ReadFields -Methode zum Extrahieren von Textfeldern dem Aufteilen der Zeichenfolgen ähnelt.

Der TextFieldParser kann zwei Dateitypen analysieren: durch Trennzeichen oder mit fester Breite. Einige Eigenschaften, z Delimiters . B. und HasFieldsEnclosedInQuotes , sind nur bei der Arbeit mit durch Trennzeichen getrennten Dateien sinnvoll, während die FieldWidths -Eigenschaft nur bei Der Arbeit mit Dateien mit fester Breite von Bedeutung ist.

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die das Microsoft.VisualBasic.FileIO.TextFieldParser-Objekt betreffen.

Beschreibung Siehe
Lesen aus einer Textdatei mit Trennzeichen Vorgehensweise: Lesen aus durch Trennzeichen getrennten Textdateien
Lesen aus einer Textdatei mit fester Breite Vorgehensweise: Lesen aus Textdateien mit fester Breite
Lesen aus einer Textdatei mit mehreren Formaten Vorgehensweise: Lesen aus Textdateien mit mehreren Formaten

Konstruktoren

TextFieldParser(Stream)

Initialisiert eine neue Instanz der TextFieldParser-Klasse.

TextFieldParser(Stream, Encoding)

Initialisiert eine neue Instanz der TextFieldParser-Klasse.

TextFieldParser(Stream, Encoding, Boolean)

Initialisiert eine neue Instanz der TextFieldParser-Klasse.

TextFieldParser(Stream, Encoding, Boolean, Boolean)

Initialisiert eine neue Instanz der TextFieldParser-Klasse.

TextFieldParser(String)

Initialisiert eine neue Instanz der TextFieldParser-Klasse.

TextFieldParser(String, Encoding)

Initialisiert eine neue Instanz der TextFieldParser-Klasse.

TextFieldParser(String, Encoding, Boolean)

Initialisiert eine neue Instanz der TextFieldParser-Klasse.

TextFieldParser(TextReader)

Initialisiert eine neue Instanz der TextFieldParser-Klasse.

Eigenschaften

CommentTokens

Definiert Kommentartoken. Ein Kommentartoken ist eine Zeichenfolge am Anfang einer Zeile, die angibt, dass die Zeile ein Kommentar ist und vom Parser ignoriert werden soll.

Delimiters

Definiert die Trennzeichen für eine Textdatei.

EndOfData

Gibt True zurück, wenn sich zwischen der aktuellen Cursorposition und dem Dateiende keine Zeilen befinden, die nicht leer bzw. keine Kommentare sind.

ErrorLine

Gibt die Zeile zurück, die die letzte MalformedLineException-Ausnahme verursacht hat.

ErrorLineNumber

Gibt die Nummer der Zeile zurück, die die letzte MalformedLineException-Ausnahme verursacht hat.

FieldWidths

Kennzeichnet die Breite der einzelnen Spalten in der Textdatei, die analysiert wird.

HasFieldsEnclosedInQuotes

Gibt beim Analysieren einer Datei mit Trennzeichen an, ob die Felder in Anführungszeichen eingeschlossen sind.

LineNumber

Gibt die aktuelle Zeilennummer oder -1 zurück, wenn im Stream keine weiteren Zeichen verfügbar sind.

TextFieldType

Gibt an, ob die zu analysierende Datei Trennzeichen enthält oder eine feste Breite aufweist.

TrimWhiteSpace

Gibt an, ob vorangestellte und nachfolgende Leerzeichen aus Feldwerten entfernt werden sollen.

Methoden

Close()

Schließt das aktuelle TextFieldParser-Objekt.

Dispose()

Gibt vom TextFieldParser-Objekt verwendete Ressourcen frei.

Dispose(Boolean)

Gibt vom TextFieldParser-Objekt verwendete Ressourcen frei.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
Finalize()

Ermöglicht es dem TextFieldParser, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor dieser vom Garbage Collector wieder zugänglich gemacht wird.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
PeekChars(Int32)

Liest die angegebene Anzahl von Zeichen, ohne die Cursorposition zu ändern.

ReadFields()

Liest alle Felder in der aktuellen Zeile, gibt sie als Zeichenfolgenarray zurück und setzt den Cursor in die nächste Zeile mit Daten.

ReadLine()

Gibt die aktuelle Zeile als Zeichenfolge zurück und setzt den Cursor in die nächste Zeile.

ReadToEnd()

Liest die verbleibende Textdatei und gibt sie als Zeichenfolge zurück.

SetDelimiters(String[])

Legt die Trennzeichen für den Reader auf die angegebenen Werte und den Feldtyp auf Delimited fest.

SetFieldWidths(Int32[])

Legt die Trennzeichen für den Reader auf die angegebenen Werte fest.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

IDisposable.Dispose()

Gibt vom TextFieldParser-Objekt verwendete Ressourcen frei.

Gilt für:

Weitere Informationen