TextFieldParser TextFieldParser TextFieldParser TextFieldParser Class

Definition

Stellt Methoden und Eigenschaften zur Analyse strukturierter Textdateien bereit.Provides methods and properties for parsing structured text files.

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

Beispiele

In diesem Beispiel wird mithilfe einer Textdatei mit Tabstopptrennzeichen analysiert Bigfile.This example parses through a tab-delimited text file, 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

Die TextFieldParser Objekt bietet Methoden und Eigenschaften für die Analyse strukturierter Textdateien.The TextFieldParser object provides methods and properties for parsing structured text files. Analysieren einer Textdatei mit dem TextFieldParser ähnelt dem Durchlaufen einer Textdatei, während die ReadFields ähnelt der Methode zum Extrahieren von Text zum Aufteilen von Zeichenfolgen.Parsing a text file with the TextFieldParser is similar to iterating over a text file, while the ReadFields method to extract fields of text is similar to splitting the strings.

Die TextFieldParser können zwei Arten von Dateien analysieren: durch Trennzeichen getrennten oder eine feste Breite.The TextFieldParser can parse two types of files: delimited or fixed-width. Einige Eigenschaften, z. B. Delimiters und HasFieldsEnclosedInQuotes sind nur sinnvoll bei der Arbeit mit durch Trennzeichen getrennte Dateien zwar die FieldWidths -Eigenschaft ist sinnvoll, nur bei der Arbeit mit Dateien mit fester Breite.Some properties, such as Delimiters and HasFieldsEnclosedInQuotes are meaningful only when working with delimited files, while the FieldWidths property is meaningful only when working with fixed-width files.

Die folgende Tabelle enthält Beispiele für Aufgaben im Zusammenhang mit der Microsoft.VisualBasic.FileIO.TextFieldParser Objekt.The following table lists examples of tasks involving the Microsoft.VisualBasic.FileIO.TextFieldParser object.

BeschreibungTo SieheSee
Lesen Sie aus einer durch Trennzeichen getrennten TextdateiRead from a delimited text file Gewusst wie: Lesen aus Textdateien mit KommatrennungHow to: Read From Comma-Delimited Text Files
Lesen Sie aus einer Textdatei mit fester BreiteRead from a fixed-width text file Gewusst wie: Lesen aus einer Textdatei mit fester BreiteHow to: Read From Fixed-width Text Files
Lesen Sie aus einer Textdatei mit mehreren FormatenRead from a text file with multiple formats Gewusst wie: Lesen aus Textdateien mit mehreren FormatenHow to: Read From Text Files with Multiple Formats

Konstruktoren

TextFieldParser(Stream) TextFieldParser(Stream) TextFieldParser(Stream) TextFieldParser(Stream)

Initialisiert eine neue Instanz der TextFieldParser-Klasse.Initializes a new instance of the TextFieldParser class.

TextFieldParser(Stream, Encoding) TextFieldParser(Stream, Encoding) TextFieldParser(Stream, Encoding) TextFieldParser(Stream, Encoding)

Initialisiert eine neue Instanz der TextFieldParser-Klasse.Initializes a new instance of the TextFieldParser class.

TextFieldParser(Stream, Encoding, Boolean) TextFieldParser(Stream, Encoding, Boolean) TextFieldParser(Stream, Encoding, Boolean) TextFieldParser(Stream, Encoding, Boolean)

Initialisiert eine neue Instanz der TextFieldParser-Klasse.Initializes a new instance of the TextFieldParser class.

TextFieldParser(Stream, Encoding, Boolean, Boolean) TextFieldParser(Stream, Encoding, Boolean, Boolean) TextFieldParser(Stream, Encoding, Boolean, Boolean) TextFieldParser(Stream, Encoding, Boolean, Boolean)

Initialisiert eine neue Instanz der TextFieldParser-Klasse.Initializes a new instance of the TextFieldParser class.

TextFieldParser(String) TextFieldParser(String) TextFieldParser(String) TextFieldParser(String)

Initialisiert eine neue Instanz der TextFieldParser-Klasse.Initializes a new instance of the TextFieldParser class.

TextFieldParser(String, Encoding) TextFieldParser(String, Encoding) TextFieldParser(String, Encoding) TextFieldParser(String, Encoding)

Initialisiert eine neue Instanz der TextFieldParser-Klasse.Initializes a new instance of the TextFieldParser class.

TextFieldParser(String, Encoding, Boolean) TextFieldParser(String, Encoding, Boolean) TextFieldParser(String, Encoding, Boolean) TextFieldParser(String, Encoding, Boolean)

Initialisiert eine neue Instanz der TextFieldParser-Klasse.Initializes a new instance of the TextFieldParser class.

TextFieldParser(TextReader) TextFieldParser(TextReader) TextFieldParser(TextReader) TextFieldParser(TextReader)

Initialisiert eine neue Instanz der TextFieldParser-Klasse.Initializes a new instance of the TextFieldParser class.

Eigenschaften

CommentTokens CommentTokens CommentTokens CommentTokens

Definiert Kommentartoken.Defines comment tokens. Ein Kommentartoken ist eine Zeichenfolge am Anfang einer Zeile, die angibt, dass die Zeile ein Kommentar ist und vom Parser ignoriert werden soll.A comment token is a string that, when placed at the beginning of a line, indicates that the line is a comment and should be ignored by the parser.

Delimiters Delimiters Delimiters Delimiters

Definiert die Trennzeichen für eine Textdatei.Defines the delimiters for a text file.

EndOfData EndOfData EndOfData EndOfData

Gibt True zurück, wenn sich zwischen der aktuellen Cursorposition und dem Dateiende keine Zeilen befinden, die nicht leer bzw. keine Kommentare sind.Returns True if there are no non-blank, non-comment lines between the current cursor position and the end of the file.

ErrorLine ErrorLine ErrorLine ErrorLine

Gibt die Zeile zurück, die die letzte MalformedLineException-Ausnahme verursacht hat.Returns the line that caused the most recent MalformedLineException exception.

ErrorLineNumber ErrorLineNumber ErrorLineNumber ErrorLineNumber

Gibt die Nummer der Zeile zurück, die die letzte MalformedLineException-Ausnahme verursacht hat.Returns the number of the line that caused the most recent MalformedLineException exception.

FieldWidths FieldWidths FieldWidths FieldWidths

Kennzeichnet die Breite der einzelnen Spalten in der Textdatei, die analysiert wird.Denotes the width of each column in the text file being parsed.

HasFieldsEnclosedInQuotes HasFieldsEnclosedInQuotes HasFieldsEnclosedInQuotes HasFieldsEnclosedInQuotes

Gibt beim Analysieren einer Datei mit Trennzeichen an, ob die Felder in Anführungszeichen eingeschlossen sind.Denotes whether fields are enclosed in quotation marks when a delimited file is being parsed.

LineNumber LineNumber LineNumber LineNumber

Gibt die aktuelle Zeilennummer oder -1 zurück, wenn im Stream keine weiteren Zeichen verfügbar sind.Returns the current line number, or returns -1 if no more characters are available in the stream.

TextFieldType TextFieldType TextFieldType TextFieldType

Gibt an, ob die zu analysierende Datei Trennzeichen enthält oder eine feste Breite aufweist.Indicates whether the file to be parsed is delimited or fixed-width.

TrimWhiteSpace TrimWhiteSpace TrimWhiteSpace TrimWhiteSpace

Gibt an, ob vorangestellte und nachfolgende Leerzeichen aus Feldwerten entfernt werden sollen.Indicates whether leading and trailing white space should be trimmed from field values.

Methoden

Close() Close() Close() Close()

Schließt das aktuelle TextFieldParser-Objekt.Closes the current TextFieldParser object.

Dispose() Dispose() Dispose() Dispose()

Gibt vom TextFieldParser-Objekt verwendete Ressourcen frei.Releases resources used by the TextFieldParser object.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt vom TextFieldParser-Objekt verwendete Ressourcen frei.Releases resources used by the TextFieldParser object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Ermöglicht es dem TextFieldParser, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor dieser vom Garbage Collector wieder zugänglich gemacht wird.Allows the TextFieldParser object to attempt to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
PeekChars(Int32) PeekChars(Int32) PeekChars(Int32) PeekChars(Int32)

Liest die angegebene Anzahl von Zeichen, ohne die Cursorposition zu ändern.Reads the specified number of characters without advancing the cursor.

ReadFields() ReadFields() ReadFields() 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.Reads all fields on the current line, returns them as an array of strings, and advances the cursor to the next line containing data.

ReadLine() ReadLine() ReadLine() ReadLine()

Gibt die aktuelle Zeile als Zeichenfolge zurück und setzt den Cursor in die nächste Zeile.Returns the current line as a string and advances the cursor to the next line.

ReadToEnd() ReadToEnd() ReadToEnd() ReadToEnd()

Liest die verbleibende Textdatei und gibt sie als Zeichenfolge zurück.Reads the remainder of the text file and returns it as a string.

SetDelimiters(String[]) SetDelimiters(String[]) SetDelimiters(String[]) SetDelimiters(String[])

Legt die Trennzeichen für den Reader auf die angegebenen Werte und den Feldtyp auf Delimited fest.Sets the delimiters for the reader to the specified values, and sets the field type to Delimited.

SetFieldWidths(Int32[]) SetFieldWidths(Int32[]) SetFieldWidths(Int32[]) SetFieldWidths(Int32[])

Legt die Trennzeichen für den Reader auf die angegebenen Werte fest.Sets the delimiters for the reader to the specified values.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

Gilt für:

Siehe auch