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