TextFieldParser-Objekt

Aktualisiert: November 2007

Stellt Methoden und Eigenschaften zur Analyse strukturierter Textdateien bereit.

Public Class TextFieldParser

Ausnahmen

Die folgende Bedingung kann einen Ausnahmefehler verursachen:

• Ein Textfeld stimmt nicht mit dem angegebenen Format überein. Zum Beispiel stimmt eines der Felder in einer Datei mit fester Breite nicht mit der angegebenen Breite überein (MalformedLineException).

Hinweise

Das TextFieldParser-Objekt stellt Methoden und Eigenschaften zum Analysieren strukturierter Textdateien bereit. Die Analyse einer Textdatei mit TextFieldParser ist vergleichbar mit dem Durchlaufen einer Textdatei, während die ReadFields-Methode zum Extrahieren von Textfeldern mit dem Teilen der Zeichenfolgen vergleichbar ist.

TextFieldParser kann zwei Arten von Dateien analysieren: Dateien mit Trennzeichen und Dateien mit fester Breite. Manche Eigenschaften, z. B. Delimiters und HasFieldsEnclosedInQuotes, sind nur bei Dateien mit Trennzeichen sinnvoll, während die FieldWidths-Eigenschaft nur bei Dateien mit fester Breite sinnvoll ist.

Aufgaben

In der folgenden Tabelle werden Beispiele für Aufgaben mit dem Microsoft.VisualBasic.FileIO.TextFieldParser-Objekt aufgeführt.

Beispiel

In diesem Beispiel wird eine tabstoppgetrennte 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

Diese Beispiel setzt das Vorhandensein einer Funktion (processFields) voraus, die die Felder verarbeitet, während diese gelesen werden.

Anforderungen

Namespace:Microsoft.VisualBasic.FileIO

Klasse:TextFieldParser

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Siehe auch

Aufgaben

Problembehandlung bei Ausnahmen: Microsoft.VisualBasic.FileIO.TextFieldParser.MalformedLineException

Konzepte

Analysieren von Textdateien mit dem TextFieldParser-Objekt

Referenz

TextFieldParser-Objektmember

TextFieldParser.CommentTokens-Eigenschaft

TextFieldParser.Delimiters-Eigenschaft

TextFieldParser.EndOfData-Eigenschaft

TextFieldParser.ErrorLine-Eigenschaft

TextFieldParser.ErrorLineNumber-Eigenschaft

TextFieldParser.FieldWidths-Eigenschaft

TextFieldParser.HasFieldsEnclosedInQuotes-Eigenschaft

TextFieldParser.LineNumber-Eigenschaft

TextFieldParser.TextFieldType-Eigenschaft

TextFieldParser.TrimWhiteSpace-Eigenschaft

TextFieldParser.Close-Methode

TextFieldParser.PeekChars-Methode

TextFieldParser.ReadFields-Methode

TextFieldParser.ReadLine-Methode

TextFieldParser.ReadToEnd-Methode

TextFieldParser.SetDelimiters-Methode

TextFieldParser.SetFieldWidths-Methode

My.Computer.FileSystem.OpenTextFieldParser-Methode

Microsoft.VisualBasic.FileIO.TextFieldParser