TextFieldParser Klasse

Referenz

Definition

Namespace:: Microsoft.VisualBasic.FileIO

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

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 werden durch eine tabdelimitierte Textdatei analysiert. 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 bietet Methoden und Eigenschaften für die Analyse strukturierter Textdateien. Das Analysieren einer Textdatei mit der TextFieldParser Iterierung über eine Textdatei ähnelt der Verwendung der ReadFields Methode zum Extrahieren von Textfeldern ähnlich dem Teilen der Zeichenfolgen.

Dies TextFieldParser kann zwei Arten von Dateien analysieren: Trennzeichen oder feste Breite. Einige Eigenschaften, wie z Delimiters . B. und HasFieldsEnclosedInQuotes sind nur dann sinnvoll, wenn Sie mit getrennten Dateien arbeiten, während die FieldWidths Eigenschaft nur beim Arbeiten mit Fixed-Width-Dateien sinnvoll ist.

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

Beschreibung	Siehe
Aus einer getrennten Textdatei lesen	Vorgehensweise: Lesen aus durch Trennzeichen getrennten Textdateien
Aus einer Textdatei mit fester Breite lesen	Vorgehensweise: Lesen aus Textdateien mit fester Breite
Aus einer Textdatei mit mehreren Formaten lesen	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