TextFieldParser Klasse

Referenz

Definition

Namespace:: Microsoft.VisualBasic.FileIO

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Quelle:: TextFieldParser.vb

Quelle:: TextFieldParser.vb

Quelle:: TextFieldParser.vb

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Implementiert: IDisposable

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, Encoding, Boolean, Boolean)	Initialisiert eine neue Instanz der `TextFieldParser`-Klasse.
TextFieldParser(Stream, Encoding, Boolean)	Initialisiert eine neue Instanz der `TextFieldParser`-Klasse.
TextFieldParser(Stream, Encoding)	Initialisiert eine neue Instanz der `TextFieldParser`-Klasse.
TextFieldParser(Stream)	Initialisiert eine neue Instanz der `TextFieldParser`-Klasse.
TextFieldParser(String, Encoding, Boolean)	Initialisiert eine neue Instanz der `TextFieldParser`-Klasse.
TextFieldParser(String, Encoding)	Initialisiert eine neue Instanz der `TextFieldParser`-Klasse.
TextFieldParser(String)	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:

Freigeben über