TextFieldParser Klass

Definition

Namnområde:
Microsoft.VisualBasic.FileIO
Sammansättning:
Microsoft.VisualBasic.dll

Innehåller metoder och egenskaper för parsning av strukturerade textfiler.

public ref class TextFieldParser : IDisposable
public class TextFieldParser : IDisposable
type TextFieldParser = class
    interface IDisposable
Public Class TextFieldParser
Implements IDisposable
Arv
Object
TextFieldParser
Implementeringar
IDisposable

Exempel

Det här exemplet parsar genom en flikavgränsad textfil, 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

Kommentarer

Objektet TextFieldParser innehåller metoder och egenskaper för parsning av strukturerade textfiler. Att parsa en textfil med TextFieldParser liknar iterering över en textfil, medan användningen ReadFields av metoden för att extrahera textfält liknar att dela upp strängarna.

Kan TextFieldParser parsa två typer av filer: avgränsade eller fast bredd. Vissa egenskaper, till exempel Delimiters och HasFieldsEnclosedInQuotes är bara meningsfulla när du arbetar med avgränsade filer, medan FieldWidths egenskapen bara är meningsfull när du arbetar med filer med fast bredd.

I följande tabell visas exempel på uppgifter som involverar objektet Microsoft.VisualBasic.FileIO.TextFieldParser.

Till Se
Läsa från en avgränsad textfil Anvisningar: Läsa från Comma-Delimited textfiler
Läsa från en textfil med fast bredd Anvisningar: Läsa från textfiler med fast bredd
Läsa från en textfil med flera format Anvisningar: Läsa från textfiler med flera format

Konstruktorer

Name Description
TextFieldParser(Stream, Encoding, Boolean, Boolean)

Initierar en ny instans av TextFieldParser klassen.
TextFieldParser(Stream, Encoding, Boolean)

Initierar en ny instans av TextFieldParser klassen.
TextFieldParser(Stream, Encoding)

Initierar en ny instans av TextFieldParser klassen.
TextFieldParser(Stream)

Initierar en ny instans av TextFieldParser klassen.
TextFieldParser(String, Encoding, Boolean)

Initierar en ny instans av TextFieldParser klassen.
TextFieldParser(String, Encoding)

Initierar en ny instans av TextFieldParser klassen.
TextFieldParser(String)

Initierar en ny instans av TextFieldParser klassen.
TextFieldParser(TextReader)

Initierar en ny instans av TextFieldParser klassen.

Egenskaper

Name Description
CommentTokens

Definierar kommentarstoken. En kommentarstoken är en sträng som, när den placeras i början av en rad, anger att raden är en kommentar och bör ignoreras av parsern.
Delimiters

Definierar avgränsarna för en textfil.
EndOfData

Returnerar True om det inte finns några icke-tomma, icke-kommentarslinjer mellan den aktuella markörens position och slutet av filen.
ErrorLine

Returnerar raden som orsakade det senaste MalformedLineException undantaget.
ErrorLineNumber

Returnerar antalet rader som orsakade det senaste MalformedLineException undantaget.
FieldWidths

Anger bredden på varje kolumn i textfilen som parsas.
HasFieldsEnclosedInQuotes

Anger om fält omges av citattecken när en avgränsad fil parsas.
LineNumber

Returnerar det aktuella radnumret eller returnerar -1 om inga fler tecken är tillgängliga i strömmen.
TextFieldType

Anger om filen som ska parsas är avgränsad eller har fast bredd.
TrimWhiteSpace

Anger om inledande och avslutande blanksteg ska trimmas från fältvärden.

Metoder

Name Description
Close()

Stänger det aktuella TextFieldParser objektet.
Dispose()

Frigör resurser som används av TextFieldParser objektet.
Dispose(Boolean)

Frigör resurser som används av TextFieldParser objektet.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
Finalize()

TextFieldParser Tillåter att objektet försöker frigöra resurser och utföra andra rensningsåtgärder innan det frigörs av skräpinsamling.
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
PeekChars(Int32)

Läser det angivna antalet tecken utan att flytta markören framåt.
ReadFields()

Läser alla fält på den aktuella raden, returnerar dem som en matris med strängar och flyttar markören till nästa rad som innehåller data.
ReadLine()

Returnerar den aktuella raden som en sträng och flyttar markören till nästa rad.
ReadToEnd()

Läser resten av textfilen och returnerar den som en sträng.
SetDelimiters(String[])

Anger avgränsarna för läsaren till de angivna värdena och anger fälttypen till Delimited.
SetFieldWidths(Int32[])

Anger avgränsarna för läsaren till de angivna värdena.
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Gäller för

Se även