TextFieldParser.ReadFields Methode

Referenz

Definition

Namespace:: Microsoft.VisualBasic.FileIO

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Quelle:: TextFieldParser.vb

Quelle:: TextFieldParser.vb

Quelle:: TextFieldParser.vb

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.

Liest alle Felder in der aktuellen Zeile, gibt sie als Zeichenfolgenarray zurück und setzt den Cursor in die nächste Zeile mit Daten.

public:
 cli::array <System::String ^> ^ ReadFields();

public string[]? ReadFields ();

public string[] ReadFields ();

member this.ReadFields : unit -> string[]

Public Function ReadFields () As String()

Gibt zurück

String[]

Ein Array von Zeichenfolgen, das Feldwerte für die aktuelle Zeile enthält.

Ausnahmen

MalformedLineException

Ein Feld kann mit dem angegebenen Format nicht analysiert werden.

Beispiele

In diesem Beispiel wird die ReadFields -Methode verwendet, um aus der durch Trennzeichen getrennten Datei ParserText.txtzu lesen. Im Beispiel werden die Felder in geschrieben Testfile.txt.

Using MyReader As New Microsoft.VisualBasic.FileIO.TextFieldParser("C:\ParserText.txt")
    MyReader.TextFieldType = Microsoft.VisualBasic.FileIO.FieldType.Delimited
    MyReader.Delimiters = New String() {","}
    Dim currentRow As String()
    While Not MyReader.EndOfData
        Try
            currentRow = MyReader.ReadFields()
            For Each currentField As String In currentRow
                My.Computer.FileSystem.WriteAllText(
                    "C://testfile.txt", currentField, True)
            Next
        Catch ex As Microsoft.VisualBasic.FileIO.MalformedLineException
            MsgBox("Line " & ex.Message & " is invalid.  Skipping")
        End Try
    End While
End Using

Hinweise

Damit Benutzer Textdateien in mehreren Formaten analysieren können, untersucht die ReadFields -Methode bei jedem Aufruf die Werte von TextFieldType, Delimitersund FieldWidths, wenn sie angegeben werden. Benutzer müssen die TextFieldType Eigenschaften und FieldWidths oder Delimiters ordnungsgemäß konfigurieren. Wenn TextFieldType auf Delimitedfestgelegt ist und Delimiters nicht festgelegt ist, oder wenn TextFieldType auf FixedWidth und FieldWidthsfestgelegt ist, wird eine Ausnahme ausgelöst.

Wenn ReadFields Leerzeilen auftreten, werden diese übersprungen, und die nächste zeile ohne Leerzeichen wird zurückgegeben.

Wenn die ReadFields Methode die aktuelle Zeile nicht analysieren kann, löst sie eine Ausnahme aus und wechselt nicht zur nächsten Zeile. Dadurch kann Ihre Anwendung versuchen, die Zeile erneut zu analysieren.

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die ReadFields -Methode betreffen.

Beschreibung	Siehe
Lesen aus einer Datei mit Trennzeichen	Vorgehensweise: Lesen aus durch Trennzeichen getrennten Textdateien
Aus einer Datei mit fester Breite lesen	Vorgehensweise: Lesen aus Textdateien mit fester Breite

Gilt für: