TextFieldParser Klasse

Definition

Namespace:
Microsoft.VisualBasic.FileIO
Assembly:
Microsoft.VisualBasic.dll

Stellt Methoden und Eigenschaften zum Analysieren 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 eine durch Tabstopp getrennte 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 stellt Methoden und Eigenschaften zum Analysieren strukturierter Textdateien bereit. Das Analysieren einer Textdatei mit der ist mit dem TextFieldParser Durchlaufen einer Textdatei vergleichbar, während die Verwendung der ReadFields Methode zum Extrahieren von Textfeldern dem Aufteilen der Zeichenfolgen ähnelt.

Die TextFieldParser Beiden Dateitypen können analysiert werden: durch Trennzeichen oder feste Breite. Einige Eigenschaften, z Delimiters . B. und HasFieldsEnclosedInQuotes sind nur dann sinnvoll, wenn Sie mit durch Trennzeichen getrennten Dateien arbeiten, während die FieldWidths Eigenschaft nur dann sinnvoll ist, wenn Sie mit Dateien mit fester Breite arbeiten.

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

To Siehe
Lesen aus einer durch Trennzeichen getrennten Textdatei Vorgehensweise: Lesen aus Comma-Delimited 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

Name Beschreibung
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

Name Beschreibung
CommentTokens

Definiert Kommentartoken. Ein Kommentartoken ist eine Zeichenfolge, die, wenn sie am Anfang einer Zeile platziert wird, angibt, dass es sich bei der Zeile um einen Kommentar handelt und vom Parser ignoriert werden soll.
Delimiters

Definiert die Trennzeichen für eine Textdatei.
EndOfData

Gibt zurück True , wenn keine nicht leeren, nicht kommentarfreien Zeilen zwischen der aktuellen Cursorposition und dem Ende der Datei vorhanden 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

Gibt die Breite jeder Spalte in der zu analysierenden Textdatei an.
HasFieldsEnclosedInQuotes

Gibt an, ob Felder in Anführungszeichen eingeschlossen werden, wenn eine durch Trennzeichen getrennte Datei analysiert wird.
LineNumber

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

Gibt an, ob die zu analysierende Datei durch Trennzeichen oder feste Breite getrennt ist.
TrimWhiteSpace

Gibt an, ob führende und nachfolgende Leerzeichen aus Feldwerten gekürzt werden sollen.

Methoden

Name Beschreibung
Close()

Schließt das aktuelle TextFieldParser Objekt.
Dispose()

Gibt Ressourcen frei, die TextFieldParser vom Objekt verwendet werden.
Dispose(Boolean)

Gibt Ressourcen frei, die TextFieldParser vom Objekt verwendet werden.
Equals(Object)

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

(Geerbt von Object)
Finalize()

Ermöglicht es dem TextFieldParser Objekt, Ressourcen freizugeben und andere Bereinigungsvorgänge auszuführen, bevor es von der Garbage Collection erneut beansprucht wird.
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
PeekChars(Int32)

Liest die angegebene Anzahl von Zeichen, ohne den Cursor vorwärts zu bewegen.
ReadFields()

Liest alle Felder in der aktuellen Zeile, gibt sie als Array von Zeichenfolgen zurück und wechselt zum Cursor zur nächsten Zeile, die Daten enthält.
ReadLine()

Gibt die aktuelle Zeile als Zeichenfolge zurück und wechselt zum Cursor zur nächsten Zeile.
ReadToEnd()

Liest den Rest der Textdatei und gibt sie als Zeichenfolge zurück.
SetDelimiters(String[])

Legt die Trennzeichen für den Leser auf die angegebenen Werte fest und legt den Feldtyp auf Delimited.
SetFieldWidths(Int32[])

Legt die Trennzeichen für den Leser auf die angegebenen Werte fest.
ToString()

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

(Geerbt von Object)

Gilt für:

Weitere Informationen